ドラフト ECMA-262 / 2025年7月24日
ECMAScript® 2026 言語仕様
この仕様について
https://tc39.es/ecma262/ のドキュメントは、最も正確で 最新の ECMAScript 仕様です。これは最新の年次スナップショットの内容に加え、スナップショット取得以降の 完了した提案 （提案プロセスで Stage 4 に達し、複数の実装で利用可能となり、次回の実際の改訂に含まれるもの）も含まれています。
このドキュメントは 単一ページ および 複数ページ で利用可能です。
この仕様への貢献について
この仕様は、ECMAScript コミュニティの協力のもと GitHub で開発されています。仕様の開発に貢献する方法はいくつかあります：
- GitHub リポジトリ: https://github.com/tc39/ecma262
- イシュー: 全イシュー, 新規イシューの作成
- プルリクエスト: 全プルリクエスト, 新規プルリクエストの作成
- テストスイート: Test262
- 編集者:
-
コミュニティ:
- Discourse: https://es.discourse.group/
- チャット: Matrix
- メーリング
リスト アーカイブ: https://esdiscuss.org/
このドキュメントの作成方法については
はじめに
このEcma規格は、ECMAScript 2026言語を定義します。これはECMAScript言語仕様の第17版です。1997年の初版発行以来、ECMAScriptは世界で最も広く使われている汎用プログラミング言語のひとつに成長しました。主にウェブブラウザに組み込まれている言語として知られていますが、サーバーや組み込みアプリケーションにも広く採用されています。
ECMAScriptは、主にJavaScript（Netscape）やJScript（Microsoft）など、いくつかの元技術に基づいています。この言語はBrendan EichによってNetscapeで発明され、同社のNavigator 2.0ブラウザで初めて登場しました。その後、Netscapeのすべてのブラウザと、MicrosoftのInternet Explorer 3.0以降のすべてのブラウザに実装されています。
ECMAScript言語仕様の開発は1996年11月に始まりました。このEcma規格の初版は、1997年6月のEcma総会で採択されました。
そのEcma規格はISO/IEC JTC 1に迅速な審査手続きで提出され、1998年4月に国際規格ISO/IEC 16262として承認されました。1998年6月のEcma総会では、ISO/IEC 16262と完全に一致させるため、ECMA-262第2版が承認されました。第1版と第2版の変更点は編集上のものです。
第3版では、強力な正規表現、より優れた文字列操作、新しい制御文、try/catch例外処理、エラー定義の厳格化、数値出力の書式指定、将来的な言語拡張を見据えた小規模な変更などが導入されました。ECMAScript標準の第3版は、1999年12月のEcma総会で採択され、2002年6月にISO/IEC 16262:2002として発行されました。
第3版発行後、ECMAScriptはWorld Wide Webとともに爆発的な普及を遂げ、ほぼすべてのウェブブラウザが対応するプログラミング言語となりました。第4版の開発も進みましたが、完成には至らず正式な第4版として発行されませんでした。ただし、その一部は第6版の開発に取り込まれています。
ECMAScript第5版（ECMA-262第5版として発行）は、ブラウザ実装で一般的となった言語仕様の事実上の解釈を明文化し、第3版発行以降に登場した新機能も追加しました。これらには、
第5版はISO/IEC JTC 1に迅速な審査手続きで提出され、国際規格ISO/IEC 16262:2011として承認されました。ECMAScript標準の第5.1版は細かな修正を取り入れており、ISO/IEC 16262:2011と同じ内容です。第5.1版は2011年6月のEcma総会で採択されました。
第6版の本格的な開発は2009年に始まりましたが、これは第3版（1999年発行）以降に行われてきたさまざまな実験や言語拡張設計の集大成です。この版の目標には、大規模アプリケーションやライブラリの開発、他言語のコンパイル先としてのECMAScript利用の強化が含まれていました。主な拡張としては、モジュール、クラス宣言、レキシカルブロックスコープ、
ECMAScript 2016は、Ecma TC39の新しい年次リリース体制と公開開発プロセスの下でリリースされた最初の版です。ECMAScript
2015のソースをプレーンテキストに変換した文書が、GitHub上での開発ベースとして使われました。この標準の開発期間中、数百件のプルリクエストやイシューが提出され、何千ものバグ修正、編集修正、その他の改善が行われました。また、Ecmarkup、Ecmarkdown、Grammarkdownなどのソフトウェアツールも開発されました。ES2016では新しいべき乗演算子やArray.prototypeのincludesメソッドが追加されました。
ECMAScript 2017では、Async Functions、Shared Memory、Atomicsの導入、その他小規模な言語・ライブラリの拡張、バグ修正、編集更新が行われました。Async
FunctionsはPromiseを返す関数のための構文を提供し、非同期プログラミング体験を向上させました。Shared
MemoryとAtomicsは、並列CPU上でも確定した実行順序を維持できる原子的操作を使って複数Object.values、Object.entries、Object.getOwnPropertyDescriptorsも追加されました。
ECMAScript 2018では、dotAllフラグ、名前付きキャプチャグループ、Unicodeプロパティエスケープ、後方参照）が追加され、オブジェクトのrest/spreadプロパティも追加されました。
ECMAScript
2019では、配列の平坦化のためのflatおよびflatMap（Array.prototype）、Object.entriesの戻り値を直接新しいオブジェクトに変換するObject.fromEntries、より適切な名称のtrimStartとtrimEnd（String.prototype、従来のtrimLeft/trimRightの代替）、その他細かな構文・意味論の更新が導入されました。構文の更新にはcatchバインディングパラメータの省略や、JSONとの整合性のために文字列リテラルでU+2028（LINE
SEPARATOR）とU+2029（PARAGRAPH
SEPARATOR）を許可することなどがあります。そのほか、Array.prototype.sortの安定化、JSON.stringifyのUTF-8出力標準化、Function.prototype.toStringの仕様明確化などが行われました。
ECMAScript
2020（第11版）では、グローバル正規表現による全マッチオブジェクトのイテレータを生成するmatchAllメソッド（Strings）、動的な指定子でモジュールを非同期インポートするimport()構文、任意精度整数用の新しい数値プリミティブBigInt、短絡しない新しいPromise合成手法Promise.allSettled、グローバルthis値への統一的アクセスglobalThis、モジュール内で使うexport * as ns from 'module'構文、for-in列挙順の標準化、モジュールに関するコンテキスト情報を持つimport.meta（
ECMAScript
2021（第12版）では、Strings用のreplaceAllメソッド、Promise合成のPromise.any（入力値のいずれかがfulfilledになると短絡）、複数のエラーを同時に表現する新しいError型AggregateError、論理代入演算子（??=、&&=、||=）、ガベージコレクションから保護せずにターゲットオブジェクトを参照するWeakRef、ターゲットオブジェクトのガベージコレクション時にクリーンアップ操作を管理するFinalizationRegistry、数値リテラルの区切り文字（1_000）、Array.prototype.sortの仕様厳密化（
ECMAScript 2022（第13版）では、モジュールのトップレベルでawaitを使えるようになり（#x in obj構文（オブジェクトのprivateフィールドの存在判定）、正規表現のマッチインデックス（/dフラグ）、Errorオブジェクトのcauseプロパティ（エラーの因果関係記録）、Strings/Arrays/atメソッド（相対インデックス）、Object.hasOwn（Object.prototype.hasOwnPropertyの便利な代替）などが導入されました。
ECMAScript
2023（第14版）では、Array.prototypeとTypedArray.prototypeにtoSorted、toReversed、with、findLast、findLastIndexが追加され、Array.prototypeにはtoSplicedが追加されました。また、実行可能なECMAScriptファイルのためにファイル先頭の#!コメント対応、ほとんどのSymbolをweakコレクションのキーとして利用可能になりました。
ECMAScript
2024（第15版）では、ArrayBufferやSharedArrayBufferのリサイズ・転送機能、文字列集合処理に便利な新しいRegExpの/vフラグ、Promise構築を容易にするPromise.withResolvers、データ集計用のObject.groupByおよびMap.groupBy、共有メモリの非同期変更待機用Atomics.waitAsync、Unicodeの正当性チェックと修正用String.prototype.isWellFormed・String.prototype.toWellFormedなどが追加されました。
ECMAScript 2025（第16版）では、イテレータ操作のための新しいグローバルIterator（Set.prototype用のセット操作メソッド、JSONモジュールのインポートとインポート属性宣言構文、正規表現で安全に使えるよう文字列エスケープするRegExp.escapeメソッド、正規表現修飾フラグのインライン制御構文、関数のPromise化のためのPromise.tryメソッド、そして新しいFloat16Array（DataView.prototype.getFloat16・DataView.prototype.setFloat16・Math.f16roundメソッドが追加されました。
Ecma TC39には多くの団体を代表する何十人もの個人が本版および過去の版の発展に大きく貢献しています。さらに、TC39のECMAScript活動を支える活発なコミュニティが生まれ、数多くのドラフトのレビュー、何千件ものバグ報告、実装実験、テストスイートの提供、世界中の開発者への教育が行われています。残念ながら、貢献者全員を特定し、記載することは不可能です。
Allen Wirfs-Brock
ECMA-262, プロジェクトエディター, 第6版
Brian Terlson
ECMA-262, プロジェクトエディター, 第7〜10版
Jordan Harband
ECMA-262, プロジェクトエディター, 第10〜12版
Shu-yu Guo
ECMA-262, プロジェクトエディター, 第12〜16版
Michael Ficarra
ECMA-262, プロジェクトエディター, 第12〜16版
Kevin Gibbons
ECMA-262, プロジェクトエディター, 第12〜16版
1 範囲
本規格はECMAScript 2026汎用プログラミング言語を定義します。
2 適合性
ECMAScriptの適合実装は、本仕様で記述されているすべての型、値、オブジェクト、プロパティ、関数、プログラム構文および意味論を提供し、サポートしなければなりません。
ECMAScriptの適合実装は、入力されたソーステキストをUnicode標準およびISO/IEC 10646の最新バージョンに準拠して解釈しなければなりません。
異なる言語や国の言語的・文化的慣習に適応するプログラムをサポートするアプリケーションプログラミングインターフェース（API）を提供するECMAScriptの適合実装は、本仕様と互換性のある最新のECMA-402版で定義されるインターフェースを実装しなければなりません。
ECMAScriptの適合実装は、本仕様で記述されている内容以外にも、追加の型、値、オブジェクト、プロパティ、関数を提供してもかまいません。特に、適合実装は本仕様で記載されていないプロパティや、そのプロパティの値を、本仕様で記述されているオブジェクトに対して提供してもかまいません。
ECMAScriptの適合実装は、本仕様で記載されていないプログラム構文や正規表現構文をサポートしてもかまいません。特に、適合実装は本仕様の
ECMAScriptの適合実装は、本仕様の
ECMAScriptの適合実装は、
ECMAScriptの適合実装は、規範的オプション（Normative Optional）サブ句を実装するかどうかを選択できます。規範的オプションの動作を実装する場合は、包含している規範的オプション句内のすべての動作を実装しなければなりません。規範的オプション句は、本仕様で「Normative Optional」と表示された色付きのボックスで示されます（下記参照）。
2.1 規範的オプション句の見出し例
句の内容例。
ECMAScriptの適合実装は、規範的オプションとしてもマークされていない限り、レガシー（Legacy）サブ句を実装しなければなりません。レガシーサブ句内で規定されている言語機能や動作には、ひとつ以上の望ましくない特徴がありますが、既存アプリケーションでの利用が継続されているため、本仕様から削除できません。これらの機能はECMAScript言語の中核部分とはみなされません。プログラマーは新しいECMAScriptコードを書く際、これらの機能や動作の利用や存在を前提にすべきではありません。
2.2 レガシー句の見出し例
句の内容例。
2.3 レガシー規範的オプション句の見出し例
句の内容例。
3 規範参照文献
以下の参照文書は、本書の適用に不可欠です。日付付き参照については、引用された版のみが適用されます。日付なし参照については、参照文書の最新版（改訂および修正を含む）が適用されます。
Unicode標準。
https://unicode.org/versions/latest
ISO/IEC 10646, 情報技術 ― ユニバーサル多オクテット符号化文字集合 (UCS) と改訂1:2005、改訂2:2006、改訂3:2008、改訂4:2008、追加改訂・正誤表、または後継。
ECMA-402, ECMAScript国際化API仕様、本仕様の版に対応する年次版。
https://www.ecma-international.org/publications-and-standards/standards/ecma-402/
ECMA-404, JSONデータ交換フォーマット。
https://www.ecma-international.org/publications-and-standards/standards/ecma-404/
4 概要
この節はECMAScript言語の非規範的な概要を含みます。
ECMAScriptは、
ECMAScriptは当初スクリプト言語として設計されましたが、現在では汎用プログラミング言語として広く使われています。スクリプト言語とは、既存システムの機能を操作・カスタマイズ・自動化するためのプログラミング言語です。こうしたシステムでは、ユーザーインターフェースを通じて有用な機能がすでに利用可能であり、スクリプト言語はその機能をプログラム制御に公開する手段となります。このように、既存システムはスクリプト言語の機能を補完する
ECMAScriptは当初Webスクリプト言語として設計され、ブラウザでWebページを動的にし、Webベースのクライアントサーバーアーキテクチャの一部としてサーバ計算を行う仕組みを提供していました。現在、ECMAScriptは様々な
ECMAScriptの利用は単純なスクリプトを超え、さまざまな環境や規模で多岐にわたるプログラミング業務に使われています。利用拡大に伴い、ECMAScriptが提供する機能や設備も拡充されました。現在、ECMAScriptは完全な機能を備えた汎用プログラミング言語となっています。
4.1 Webスクリプティング
ウェブブラウザは、クライアントサイド計算のためのECMAScript
ウェブサーバは、サーバサイド計算のための別の
ECMAScriptをサポートする各Webブラウザとサーバは、それぞれ独自の
4.2 ホストと実装
ECMAScriptを
実装は、付録
実装定義機能は、定義を外部ソースに委ねるものです。本仕様は特定の動作について推奨を行わず、適合実装は本仕様で定められた制約内で任意の動作を選択できます。
実装近似機能は、定義を外部ソースに委ねつつ、理想的な動作を推奨するものです。適合実装は制約内で任意の動作を選択できますが、理想的な動作に近づけることが奨励されます。例えば、Math.exp
ホストは、付録
ホストフックは、全体または一部が外部ソースで定義される抽象操作です。すべての
ホスト定義機能は、定義を外部ソースに委ねるもので、付録
ホスト環境は、すべての
本仕様は、常に最も具体的な用語を使う編集慣例に従います。例えば、機能が
4.3 ECMAScript概要
以下はECMAScriptの非公式な概要です。言語のすべての部分が説明されているわけではありません。この概要は規格本体の一部ではありません。
ECMAScriptはオブジェクトベースです。基本的な言語機能や
ECMAScriptは、ECMAScriptエンティティの定義を補完する組み込みオブジェクトの集合も定義します。これらの組み込みオブジェクトには、Object、Function、Boolean、Symbol、各種Errorオブジェクト、数値値の表現・操作用Math、Number、Date、テキスト処理用のString、RegExp、値のインデックス付きコレクションであるArrayと9種類のTyped
Array（要素が特定の数値データ表現を持つ）、キー付きコレクションのMap、Setオブジェクト、構造化データ用のJSONオブジェクト、ArrayBuffer、SharedArrayBuffer、DataView、制御抽象のためのジェネレータ関数やPromiseオブジェクト、リフレクション用のProxyやReflectなどが含まれます。
ECMAScriptは組み込み演算子も定義しています。ECMAScriptの演算子には、様々な単項演算、乗算演算子、加算演算子、ビットシフト演算子、関係演算子、等価演算子、2項ビット演算子、2項論理演算子、代入演算子、カンマ演算子などがあります。
大規模なECMAScriptプログラムはモジュールによってサポートされており、プログラムを複数の文や宣言の列に分割できます。各モジュールは、他のモジュールから提供される必要がある宣言、および他のモジュールで利用可能な自身の宣言を明示的に識別します。
ECMAScriptの構文は意図的にJavaの構文に似せてあります。ECMAScriptの構文は、使いやすいスクリプト言語として機能するよう緩和されています。例えば、変数は型宣言が不要であり、プロパティにも型は関連付けられず、定義された関数は呼び出しより前に宣言が現れている必要はありません。
4.3.1 オブジェクト
ECMAScriptはクラス定義の構文を含みますが、ECMAScriptオブジェクトはC++、Smalltalk、Javaのように本質的にクラスベースではありません。代わりに、オブジェクトはリテラル記法やnew Date(2009, 11)は新しいDateオブジェクトを生成します。newを使わずにDate()はオブジェクトではなく現在の日時の文字列を生成します。
クラスベースのオブジェクト指向言語では、一般に、状態はインスタンスが保持し、メソッドはクラスが保持し、継承は構造と振る舞いのみです。ECMAScriptでは、状態もメソッドもオブジェクトが保持し、構造・振る舞い・状態のすべてが継承されます。
プロトタイプが特定のプロパティを持っていて、そのプロパティを直接持たないすべてのオブジェクトは、そのプロパティと値を共有します。図1はこの関係を示しています。
CFはnew式で生成されています。各オブジェクトは
ほとんどのクラスベースオブジェクト言語と異なり、オブジェクトには値を代入することで動的にプロパティを追加できます。つまり、
ECMAScriptオブジェクトは本質的にクラスベースではありませんが、共通パターンの
4.3.2 ECMAScriptの厳格なバリアント
ECMAScript言語は、言語の一部機能の利用を制限したいユーザーがいる可能性を認識しています。これは、セキュリティの観点、エラーを招きやすい機能の回避、エラー検出の強化、その他ユーザー独自の理由によるものです。この可能性をサポートするために、ECMAScriptは言語の厳格なバリアントを定義しています。厳格なバリアントでは、通常のECMAScript言語から特定の構文的・意味的機能を除外し、一部機能の詳細な意味論を変更します。厳格なバリアントでは、非厳格な言語形式ではエラーとされない状況でも、エラー例外をthrowして報告しなければならない追加のエラー条件も規定しています。
ECMAScriptの厳格なバリアントは、一般に言語のstrict mode（厳格モード）と呼ばれます。厳格モードの選択と構文・意味論の利用は、
本仕様に適合するために、ECMAScriptの実装は本仕様で定義された完全な非制限ECMAScript言語と厳格なバリアントの両方を実装しなければなりません。さらに、非制限モードと厳格モードのソーステキストユニットの組み合わせによる複合プログラムもサポートしなければなりません。
4.4 用語と定義
本書の目的において、以下の用語と定義が適用されます。
4.4.1 implementation-approximated
4.4.2 implementation-defined
4.4.3 host-defined
編集上の観点では、
4.4.4 type
4.4.5 primitive value
型 Undefined、Null、Boolean、Number、BigInt、Symbol、String のいずれかのメンバー（
プリミティブ値は、言語実装の最下層レベルで直接表現されるデータです。
4.4.6 object
型 Object のメンバー
オブジェクトはプロパティの集合体であり、単一のプロトタイプオブジェクトを持ちます。プロトタイプは
4.4.7 constructor
オブジェクトを生成・初期化する
4.4.8 prototype
他のオブジェクトに共有プロパティを提供するオブジェクト
constructor.prototype
で参照でき、プロトタイプに追加されたプロパティは継承によりそのプロトタイプを共有するすべてのオブジェクトで共有されます。あるいは、Object.create
組み込み関数を使って明示的に指定したプロトタイプ付きの新しいオブジェクトを生成することもできます。
4.4.9 ordinary object
すべてのオブジェクトがサポートすべき本質的な内部メソッドに対してデフォルトの動作を持つオブジェクト
4.4.10 exotic object
本質的な内部メソッドのうち1つ以上についてデフォルトの動作を持たないオブジェクト
4.4.11 standard object
本仕様で意味論が定義されているオブジェクト
4.4.12 built-in object
ECMAScript実装によって規定・提供されるオブジェクト
標準の組み込みオブジェクトは本仕様で定義されています。ECMAScript実装は追加の組み込みオブジェクトを規定・提供してもかまいません。
4.4.13 undefined value
変数に値が代入されていない場合に使われるプリミティブ値
4.4.14 Undefined type
唯一の値が
4.4.15 null value
いかなるオブジェクト値も意図的に存在しないことを表すプリミティブ値
4.4.16 Null type
唯一の値が
4.4.17 Boolean value
Boolean値は
4.4.18 Boolean type
プリミティブ値
4.4.19 Boolean object
標準組み込み Boolean
Booleanオブジェクトは、Boolean new
式で使い、Boolean値を引数として生成されます。生成されたオブジェクトは内部スロットにBoolean値を保持します。BooleanオブジェクトはBoolean値に強制変換することができます。
4.4.20 String value
ゼロ以上の16ビット符号なし
String値は
4.4.21 String type
すべての可能なString値の集合
4.4.22 String object
標準組み込み String
Stringオブジェクトは、String new
式で使い、String値を引数として生成されます。生成されたオブジェクトは内部スロットにString値を保持します。Stringオブジェクトは、String
4.4.23 Number value
倍精度64ビットバイナリ形式
Number値は
4.4.24 Number type
すべての可能なNumber値の集合（
4.4.25 Number object
標準組み込み Number
Numberオブジェクトは、Number new
式で使い、Number値を引数として生成されます。生成されたオブジェクトは内部スロットにNumber値を保持します。Numberオブジェクトは、Number
4.4.26 Infinity
正の無限大のNumber値
4.4.27 NaN
4.4.28 BigInt value
任意精度
4.4.29 BigInt type
すべての可能なBigInt値の集合
4.4.30 BigInt object
標準組み込み BigInt
4.4.31 Symbol value
ユニークな、非Stringオブジェクト
4.4.32 Symbol type
すべての可能なSymbol値の集合
4.4.33 Symbol object
標準組み込み Symbol
4.4.34 function
サブルーチンとして呼び出すことができる
関数はプロパティに加え、呼び出されたときの挙動を決定する実行コードと状態を持ちます。関数のコードはECMAScriptで記述されている場合とそうでない場合があります。
4.4.35 built-in function
関数である組み込みオブジェクト
組み込み関数の例：parseInt、Math.exp。
4.4.36 built-in constructor
組み込み Object、Function。
4.4.37 property
キー（String値またはSymbol値）と値を関連付けるオブジェクトの一部
プロパティの形態によって、値はデータ値（プリミティブ値、オブジェクト、
4.4.38 method
プロパティの値である関数
関数がオブジェクトのメソッドとして呼び出されると、そのオブジェクトは関数に
4.4.39 built-in method
組み込み関数であるメソッド
標準組み込みメソッドは本仕様で定義されています。
4.4.40 attribute
プロパティの特徴を定義する内部値
4.4.41 own property
オブジェクトが直接保持するプロパティ
4.4.42 inherited property
オブジェクト自身のプロパティではないが、そのオブジェクトのプロトタイプの（自身または継承された）プロパティであるプロパティ
4.5 本仕様書の構成
本仕様書の残りの部分は以下のように構成されています：
第
第
第
第
第
5 記法上の規則
5.1 構文および字句文法
5.1.1 文脈自由文法
文脈自由文法は複数の生成規則から成ります。各生成規則は、非終端記号と呼ばれる抽象記号を左辺とし、0個以上の非終端記号および終端記号記号から成る列を右辺とします。各文法において、終端記号は特定のアルファベットから選ばれます。
連鎖生成規則は、右辺にちょうど1つの非終端記号と0個以上の終端記号を持つ生成規則です。
特別な非終端記号（目標記号）のみから成る文を始点として、与えられた文脈自由文法は言語を規定します。つまり、非終端記号を対応する左辺を持つ生成規則の右辺へ繰り返し置換することで得られる終端記号の可能な（無限かもしれない）列の集合です。
5.1.2 字句文法と正規表現文法
ECMAScriptの字句文法は、
空白やコメント以外の入力要素が、ECMAScriptの構文文法の終端記号となり、ECMAScriptのトークンと呼ばれます。これらのトークンは、/*…*/形式のコメント）は、行終端子を含まなければ単純に破棄されますが、行終端子を1つ以上含む場合は、1つの行終端子に置換され、構文文法の入力要素列に含まれます。
ECMAScriptの正規表現文法は
字句文法と正規表現文法の生成規則は、区切り記号として二重コロン“::”を用いて区別されます。字句文法と正規表現文法は、いくつかの生成規則を共有します。
5.1.3 数値文字列文法
数値文字列文法は
数値文字列文法の生成規則は、三重コロン“:::”を区切り記号として区別され、ソーステキストの解析には決して使用されません。
5.1.4 構文文法
ECMAScriptの構文文法は、
コードポイントの列をECMAScriptの
解析が成功すると、構文木（根付き木構造）が構築されます。各ノードは構文ノードです。各構文ノードは文法記号のインスタンスであり、その記号から導出可能なソーステキストの範囲を表します。構文木の根ノード（ソーステキスト全体を表す）は、解析の
新しい構文ノードはパーサーの各呼び出しごとにインスタンス化され、同一ソーステキストであっても解析間で再利用されることはありません。構文ノードは、同じソーステキスト範囲を表し、同じ文法記号のインスタンスであり、同じパーサー呼び出しから生成された場合のみ同じ構文ノードとみなされます。
同じ文字列を複数回解析すると、異なる構文ノードが得られます。例えば、次のようになります：
let str = "1 + 1;";
eval(str);
eval(str);各evalの呼び出しは、strの値を
構文文法の生成規則は、区切り記号として単一コロン“:”を用いて区別されます。
曖昧さを避けるために、構文文法では時折拡張生成規則を用いて、ECMAScriptの
- Pが元々マッチしたトークン列を、Nを
目標記号 として再度解析します。Nが文法パラメータを持つ場合、Pを元々解析したときと同じ値に設定します。 - そのトークン列が、余分なトークンなく単一のNインスタンスとして解析できれば：
- そのPに対して一意となるNのインスタンス（構文ノード）を「PがカバーするN」と呼びます。
- Nおよび派生生成規則の全ての早期エラー規則は、PがカバーするNにも適用されます。
- そうでなければ（解析に失敗した場合）、早期構文エラーとなります。
5.1.5 文法記法
5.1.5.1 終端記号
ECMAScriptの文法では、一部の終端記号が固定幅フォントで表示されています。これらはソーステキストに記載されたとおりに正確に現れる必要があります。この方法で指定されたすべての終端記号コードポイントは、他のUnicode範囲に類似したコードポイントではなく、Basic
Latinブロックの適切なUnicodeコードポイントとみなされます。終端記号内のコードポイントは、\
終端記号が個々のUnicodeコードポイントである文法（すなわち字句文法、正規表現文法、数値文字列文法）では、生成規則に複数の固定幅コードポイントが連続して現れる場合、それは同じコードポイント列を個別の終端記号として記載する場合の省略記法です。
例えば、次の生成規則：
は次の省略記法です：
対照的に、構文文法では固定幅コードポイントの連続は１つの終端記号となります。
終端記号には他にも2つの形式があります：
- 字句文法と正規表現文法では、通常の印刷表現がないUnicodeコードポイントは「<ABBREV>」の形式で示されます。ここで「ABBREV」はコードポイントまたはコードポイントの集合の記憶語です。これらの形式は
Unicode書式制御文字 、空白 、および行終端子 で定義されています。 - 構文文法では、特定の終端記号（例：
IdentifierName やRegularExpressionLiteral ）はイタリック体で表示されます。これは字句文法の同名の非終端記号を参照することを示します。
5.1.5.2 非終端記号と生成規則
非終端記号はイタリック体で表示されます。非終端記号（「生成規則」とも呼ばれる）の定義は、定義される非終端記号の名前の後にコロンが1つ以上続いて導入されます（コロンの数は生成規則が属する文法を示します）。続く行に、その非終端記号の右辺の選択肢が1つ以上続きます。例えば、次の構文定義：
は、非終端記号whileトークン、左括弧トークン、
は、
5.1.5.3 オプション記号
終端記号または非終端記号の後に付く下付き接尾辞「opt」は、オプション記号を示します。オプション記号を含む選択肢は、オプション要素を省略する右辺と含める右辺の2つを実際に指定します。これはつまり：
は次の省略記法です：
また：
は次の省略記法です：
さらに次の省略記法となります：
したがって、この例では非終端記号
5.1.5.4 文法パラメータ
生成規則は「[parameters]」という下付き注釈でパラメータ化できます。これは、生成規則で定義される非終端記号の記号の後ろに接尾辞として現れます。「parameters」は名前1つまたはカンマ区切りの名前リストです。パラメータ化された生成規則は、パラメータ名全組み合わせを定義する一連の生成規則の省略記法です。これはつまり：
は次の省略記法です：
また：
は次の省略記法です：
複数パラメータの場合、生成規則の組み合わせ数は組み合わせ的に増えますが、すべてが完全な文法で参照されるとは限りません。
生成規則右辺で非終端記号への参照もパラメータ化できます。例えば：
は次の意味です：
また：
は次の意味です：
非終端記号参照はパラメータリストと「opt」接尾辞の両方を持つことができます。例えば：
は次の省略記法です：
右辺の非終端記号参照に「?」を付けると、そのパラメータ値は現在の生成規則左辺記号の該当パラメータの有無によって決まります。例えば：
は次の省略記法です：
右辺選択肢が「[+parameter]」で始まる場合、その選択肢は指定したパラメータが該当生成規則非終端記号参照で使用されている場合のみ利用できます。「[~parameter]」で始まる場合は参照にそのパラメータが使われていない場合のみ利用できます。これはつまり：
は次の省略記法です：
また：
は次の省略記法です：
5.1.5.5 one of
文法定義でコロンの後に「one of」が続く場合、続く行に現れる各終端記号が選択肢となることを示します。例えば、ECMAScriptの字句文法には次の生成規則があります：
これは次の省略記法です：
5.1.5.6 [empty]
生成規則の右辺に「[empty]」と記載されている場合、その生成規則の右辺には終端記号や非終端記号が含まれていないことを示します。
5.1.5.7 先読み制限
生成規則の右辺に「[lookahead =
seq]」が現れる場合、その生成規則は直後の入力トークン列の先頭がseqである場合のみ使用可能であることを示します。同様に「[lookahead
∈ set]」（setは
これらの条件は否定も可能です。「[lookahead ≠ seq]」はseqが直後の入力トークン列の先頭ではない場合のみ使用可能、「[lookahead ∉ set]」はsetのいずれも直後のトークン列先頭でない場合のみ使用可能です。
例として、次の定義の場合：
次の定義：
は、「n」の後に1つ以上の10進数字が続き、その先頭が偶数である場合、または10進数字がさらに続かない場合に一致します。
これらの表現が構文文法で使われる場合、直後のトークン列を一意に特定できない場合があります。これは、後続トークンを特定するには後の位置でどの字句
5.1.5.8 [no LineTerminator here]
構文文法の生成規則右辺に「[no
は、スクリプト内でthrowトークンと
制限付き生成規則で
5.1.5.9 but not
生成規則右辺で「but not」を使い、除外する展開を指定することができます。例えば次の生成規則：
は、非終端記号
5.1.5.10 説明的表現
最後に、選択肢をすべて列挙するのが非現実的な場合に限り、いくつかの非終端記号はサンセリフ体の説明的表現で記述されています：
5.2 アルゴリズム規約
この仕様書では、アルゴリズムの手順を指定するために番号付きリストを頻繁に使用します。これらのアルゴリズムは、ECMAScript言語構造の必要な意味論を正確に規定するために使われます。アルゴリズムは特定の実装技法の使用を示唆するものではありません。実際には、与えられた機能を実装するために、より効率的なアルゴリズムが利用可能な場合があります。
アルゴリズムは、順序付き・カンマ区切りの別名（エイリアス）名の列で明示的にパラメータ化される場合があります。これらはアルゴリズムの手順内で、その位置に渡された引数を参照するために使われます。オプションのパラメータは角括弧（[
, name ]）で囲んで表し、アルゴリズム手順内では必須のパラメータと同じ扱いになります。残余パラメータはパラメータリストの末尾に「...」を付けて（,
...name）表し、必須・オプションパラメータの後に渡されたすべての引数を
アルゴリズムの手順は、さらに順序付きのサブステップに分割できます。サブステップはインデントで示され、さらにインデントされたサブステップに分割できます。段階番号付け規則により、最初のレベルは英小文字、2番目はローマ小文字、3レベル以上は4番目以降で数字ラベルが使われます。例えば：
- 最上位の手順
- サブステップ。
- サブステップ。
- サブサブステップ。
- サブサブサブステップ
- サブサブサブサブステップ
- サブサブサブサブサブステップ
- サブサブサブサブステップ
- サブサブサブステップ
- サブサブステップ。
手順やサブステップは「if」条件文として記述でき、その場合サブステップは条件が真の時のみ適用されます。同じレベルの「if」条件文の次に「else」で始まる手順やサブステップは、その条件の否定です。
手順では、サブステップの反復適用を指定することもできます。
「Assert:」で始まる手順は、そのアルゴリズムの不変条件を主張します。これらの主張は、暗黙的なアルゴリズムの不変条件を明示するためのものであり、追加の意味論的要件を加えるものではなく、実装で検証する必要はありません。単にアルゴリズムの明確化のために用いられます。
アルゴリズムの手順では「Let x be someValue」の形式で値に名前付きエイリアスを宣言できます。これらのエイリアスは参照的であり、xとsomeValueは同じデータを参照し、どちらかの変更は双方に反映されます。参照的動作を避けたい場合は、手順内で「Let x be a copy of someValue」のように右辺のコピーを明示的に作成する必要があります。
宣言されたエイリアスは、その後の手順で参照できますが、宣言前の手順で参照してはなりません。エイリアスは「Set x to someOtherValue」の形式で変更できます。
5.2.1 抽象操作
この仕様の複数箇所で使用できるように、いくつかのアルゴリズムは抽象操作と呼ばれ、パラメータ化された関数形式で名前付き定義され、他のアルゴリズムから名前で参照できるようになっています。抽象操作は通常、OperationName(arg1, arg2)のような関数適用形式で参照されます。一部の抽象操作は、クラス的な仕様抽象の多態的にディスパッチされるメソッドとして扱われます。そのようなメソッド的抽象操作は、someValue.OperationName(arg1, arg2)のように参照されます。
5.2.2 構文指向操作
構文指向操作は、名前付き操作であり、その定義はECMAScript文法の生成規則（複数の選択肢がある場合はそれぞれ）に関連付けられたアルゴリズムから成ります。複数の選択肢がある生成規則には通常、各選択肢ごとに別個のアルゴリズムがあります。アルゴリズムが文法生成規則に関連付けられる場合、生成規則の終端記号および非終端記号は、アルゴリズムのパラメータのように参照できます。この際、非終端記号は、ソーステキストを解析した際に一致した実際の選択肢定義を参照します。文法生成規則やそれから派生した
生成規則選択肢に関連付けられたアルゴリズムは、通常「[ ]」などの文法注釈なしで示されます。これらの注釈は構文的認識にのみ影響し、選択肢の意味論には影響しません。
構文指向操作は、構文ノードおよび必要に応じて他のパラメータを受けて、以下のアルゴリズムの
- Let status be SyntaxDirectedOperation of
SomeNonTerminal . - Let someParseNode be the parse of some source text.
- Perform SyntaxDirectedOperation of someParseNode.
- Perform SyntaxDirectedOperation of
someParseNode with argument
"value" .
明示的に指定されない限り、すべての
しかし、
実行時意味論:
- Return
Evaluation ofStatementList .
5.2.3 実行時意味論
実行時に呼び出される必要のある意味論を規定するアルゴリズムは実行時意味論と呼ばれます。実行時意味論は
5.2.3.1 Completion ( completionRecord )
抽象操作Completionは、引数completionRecord（
Assert : completionRecordはCompletion Record である。- completionRecordを返す。
5.2.3.2 例外を投げる
「例外を投げる」と記載されたアルゴリズム手順（例）：
- TypeError例外を投げる。
は次の記述と同じ意味です：
- 新しく作成したTypeErrorオブジェクトで
ThrowCompletion を返す。
5.2.3.3 ReturnIfAbrupt
「
ReturnIfAbrupt (argument)。
は次の意味です：
Assert : argumentはCompletion Record である。- もしargumentが
abrupt completion なら、Completion (argument)を返す。 - それ以外は、argumentをargument.[[Value]]に設定する。
また、「
- Let hygienicTemp be AbstractOperation()。
Assert : hygienicTempはCompletion Record である。- もしhygienicTempが
abrupt completion なら、Completion (hygienicTemp)を返す。 - それ以外は、hygienicTempをhygienicTemp.[[Value]]に設定する。
ここでhygienicTempはReturnIfAbruptに関する手順内のみ一時的に有効です。
また、「Let result be AbstractOperation(
Assert : argumentはCompletion Record である。- もしargumentが
abrupt completion なら、Completion (argument)を返す。 - それ以外は、argumentをargument.[[Value]]に設定する。
- Let result be AbstractOperation(argument)。
5.2.3.4 ReturnIfAbruptの省略記法
?を付けることで、結果の
- ? OperationName()。
は次の手順と同じ意味です：
ReturnIfAbrupt (OperationName())。
同様に、メソッド呼び出し形式の場合：
- ? someValue.OperationName()。
は次の意味です：
ReturnIfAbrupt (someValue.OperationName())。
また、!を前置することで、抽象操作や
- Let val be ! OperationName()。
は次の手順と同じ意味です：
- Let val be OperationName()。
Assert : valはnormal completion である。- valをval.[[Value]]に設定する。
!または?を付けます：
- Perform ! SyntaxDirectedOperation of
NonTerminal 。
5.2.3.5 暗黙的な通常完了
Completion 、NormalCompletion 、ThrowCompletion 、ReturnCompletion の結果を直接返す場合Completion Record の生成結果を直接返す場合
それ以外の方法で
- Return
true 。
は次のいずれとも同じ意味です：
- Return
NormalCompletion (true )。
または
- Let completion be
NormalCompletion (true )。 - Return
Completion (completion)。
または
- Return
Completion Record { [[Type]]:normal , [[Value]]:true , [[Target]]:empty }。
- Return ? completion。
次の例は編集上の誤りです。なぜなら
- Let completion be
NormalCompletion (true )。 - Return completion。
5.2.4 静的セマンティクス
文脈自由文法だけでは、入力要素列が評価可能な有効なECMAScript
静的セマンティクス規則は名前を持ち、通常アルゴリズムで定義されます。名前付き静的セマンティクス規則は文法生成規則に関連付けられ、複数の選択肢がある生成規則には通常、各選択肢ごと・各適用規則ごとに別個のアルゴリズムが定義されます。
静的セマンティクス規則の特例として早期エラー規則があります。
5.2.5 数学演算
この仕様書では、次の種類の数値値を参照します：
- 数学値: 任意の実数で、既定の数値型です。
- 拡張数学値:
数学値 に加え、+∞と-∞を含みます。 - Numbers:
IEEE 754-2019 binary64（倍精度浮動小数点）値です。 - BigInts:
ECMAScript言語値 で、任意の整数 と一対一で対応します。
この仕様書では、数値値の種類を下付き接尾辞で区別します。下付き𝔽はNumbersを、下付きℤはBigIntsを指します。下付き接尾辞のない数値値は
この仕様書で数値値について言及する場合（例：「yの長さ」や「4つの16進数字で表される
この仕様書で整数という用語が使われる場合、特に断りがなければ、
+, ×, =, ≥などの数値演算子は、オペランドの型ごとに対応する演算を指します。
数学関数
数学関数
記法「
「clamping x between lower and upper」とは、xがlower未満ならlower、upperより大きければupper、それ以外はx自身を返します（lowerとupperは数学値でlower ≤ upper）。
数学関数
数学関数
数学関数
区間は、下限aから上限bまでの、同じ数値型の値の集合（無限・空の場合もありえます）です。各境界は包含か非包含かが示されます。区間には次の4種があります：
- 下限a（含む）から上限b（含む）の区間（包含区間）は、a ≤ x ≤ bを満たすすべてのxのみ含みます。
- 下限a（含む）から上限b（含まない）の区間は、a ≤ x < bを満たすxのみ含みます。
- 下限a（含まない）から上限b（含む）の区間は、a < x ≤ bを満たすxのみ含みます。
- 下限a（含まない）から上限b（含まない）の区間は、a < x < bを満たすxのみ含みます。
例えば、下限1（含む）から上限2（含まない）の区間は、1以上2未満のすべての
5.2.6 値記法
この仕様書では、Function.prototype.applyやlet n = 42;）とは区別されます。
5.2.7 同一性
この仕様書では、仕様値と
この仕様書の観点では、「is」は2つの値の等価性比較（例：「If bool is
ECMAScript言語の観点では、言語値は
仕様値の例として、同一性のない値には、
仕様上の同一性は、Symbol値（
6 ECMAScriptのデータ型と値
この仕様のアルゴリズムは、型が関連付けられた値を操作します。値の型は、まさにこの節で定義されているものだけです。型はさらに
6.1 ECMAScript言語型
ECMAScript言語型は、ECMAScriptプログラマがECMAScript言語で直接操作する値に対応します。ECMAScript言語型は、Undefined、Null、Boolean、String、Symbol、Number、BigInt、Objectです。ECMAScript言語値は、ECMAScript言語型で特徴付けられる値です。
6.1.1 Undefined型
Undefined型は、
6.1.2 Null型
Null型は、
6.1.3 Boolean型
Boolean型は、
6.1.4 String型
String型は、最大長253-1要素までの、0個以上の16ビット符号なし
String内容を解釈しないECMAScript操作は、これ以上意味論を与えません。String値を解釈する操作は、各要素を単一のUTF-16コード単位として扱います。ただし、ECMAScriptはこれらのコード単位の値や関係性を制限しないため、さらにString内容をUTF-16で符号化されたUnicodeコードポイントの列として解釈する操作は、不正な部分列を考慮する必要があります。こうした操作は、数値値が
-
コード単位が
リーディングサロゲート でもトレーリングサロゲート でもなければ、その値を持つコードポイントとして解釈されます。 -
2つのコード単位の並びで、最初のコード単位c1が
リーディングサロゲート 、2番目c2がトレーリングサロゲート なら、それはサロゲートペアであり、コードポイント値は(c1 - 0xD800) × 0x400 + (c2 - 0xDC00) + 0x10000となります。（11.1.3 参照） -
コード単位が
リーディングサロゲート またはトレーリングサロゲート であっても、サロゲートペア の一部でない場合は、その値を持つコードポイントとして解釈されます。
関数String.prototype.normalize（String.prototype.localeCompare（
この設計の理由は、Stringの実装を可能な限り単純かつ高性能に保つことにありました。
この仕様では、「string-concatenation of A, B, ...」という表現（各引数はString値、コード単位、またはコード単位の列）は、それぞれの引数（順番通り）のコード単位列を連結したString値を指します。
「substring of S from inclusiveStart
to
exclusiveEnd」という表現（SはString値またはコード単位の列、inclusiveStartとexclusiveEndは
この仕様の「ASCIIワード文字」は、Unicode Basic
Latinブロックのすべての文字と数字、およびU+005F（LOW LINE）だけからなる次のString値を指します：
歴史的理由により、いくつかのアルゴリズムで重要な意味を持ちます。
6.1.4.1 StringIndexOf ( string, searchValue, fromIndex )
抽象操作StringIndexOfは、引数string（String）、searchValue（String）、fromIndex（非負の
searchValueが空文字列かつfromIndex ≤ stringの長さなら、このアルゴリズムはfromIndexを返します。空文字列は文字列内のすべての位置（最後のコード単位の後も含む）で見つかったものとみなされます。
fromIndex +
searchValueの長さがstringの長さを超える場合、このアルゴリズムは常に
6.1.4.2 StringLastIndexOf ( string, searchValue, fromIndex )
抽象操作StringLastIndexOfは、引数string（String）、searchValue（String）、fromIndex（非負の
searchValueが空文字列の場合、このアルゴリズムはfromIndexを返します。空文字列は文字列内のすべての位置（最後のコード単位の後も含む）で見つかったものとみなされます。
6.1.5 Symbol型
Symbol型は、Objectプロパティのキーとして使用できるすべての非String値の集合です（
Symbol値はそれぞれ一意かつ不変です。
各Symbol値は、
6.1.5.1 既知のSymbol
既知のSymbolは、この仕様のアルゴリズムで明示的に参照される組み込みのSymbol値です。これらは通常、仕様アルゴリズムの拡張ポイントとなる値を持つプロパティのキーとして使用されます。特に規定がなければ、既知のSymbol値はすべての
この仕様書では、既知のSymbolは標準の
%Symbol.name%が使われます。特に次の名前が使われていました：@@asyncIterator、@@hasInstance、@@isConcatSpreadable、@@| 仕様名 | [[Description]] | 値と目的 |
|---|---|---|
| %Symbol.asyncIterator% |
|
オブジェクトのデフォルトのfor-await-of文の意味論で呼び出されます。
|
| %Symbol.hasInstance% |
|
instanceof演算子の意味論で呼び出されます。
|
| %Symbol.isConcatSpreadable% |
|
この値がtrueなら、Array.prototype.concat |
| %Symbol.iterator% |
|
オブジェクトのデフォルトの |
| %Symbol.match% |
|
正規表現メソッドで、正規表現を文字列に対してマッチさせます。String.prototype.match |
| %Symbol.matchAll% |
|
正規表現メソッドで、文字列に対してマッチした結果を返すString.prototype.matchAll |
| %Symbol.replace% |
|
正規表現メソッドで、文字列の一致部分を置換します。String.prototype.replace |
| %Symbol.search% |
|
正規表現メソッドで、文字列内で正規表現に一致するインデックスを返します。String.prototype.search |
| %Symbol.species% |
|
派生オブジェクトの生成に使われる |
| %Symbol.split% |
|
正規表現メソッドで、正規表現に一致するインデックスで文字列を分割します。String.prototype.split |
| %Symbol.toPrimitive% |
|
オブジェクトを対応するプリミティブ値に変換するメソッド。 |
| %Symbol.toStringTag% |
|
オブジェクトのデフォルト文字列記述の生成に使われるString値プロパティ。組み込みObject.prototype.toString |
| %Symbol.unscopables% |
|
オブジェクト値プロパティで、自身と継承したプロパティ名が、関連オブジェクトのwith環境バインディングから除外されるプロパティ名となります。
|
6.1.6 数値型
ECMAScriptには2つの組み込み数値型、Number型とBigInt型があります。以下の
数値型は一般に精度損失や切り捨てなしには変換できないため、ECMAScript言語ではこれらの型間で暗黙的な変換を提供しません。型が異なる関数を呼び出す場合、プログラマはNumberやBigInt関数を使って明示的に変換する必要があります。
ECMAScriptの初版および後続版では、特定の演算子に対し、精度損失や
6.1.6.1 Number型
Number型は、18,437,736,874,454,810,627（すなわちNaNで生成されます。）一部の実装では外部コードにより異なるNaN値を検出できる場合もありますが、その挙動は
他にも+Infinity（または単にInfinity）、-Infinityで生成されます。）
その他18,437,736,874,454,810,624（
+0（または単に0）、-0で生成されます。）
18,437,736,874,454,810,622（
18,428,729,675,200,069,632（
ここでsは1または-1、mは
残りの9,007,199,254,740,990（
ここでsは1または-1、mは
大きさが253以下のすべての正負の
この仕様の「the Number value for
x」という表現（xは正確な実数数学量、πなどの無理数であってもよい）は、次の手順で選ばれたNumber値を意味します。Number型のすべての
一部のECMAScript演算子は、特定範囲の
6.1.6.1.1 Number::unaryMinus ( x )
抽象操作Number::unaryMinusは、引数x（Number型）を受け取り、Number型を返します。呼び出し時、次の手順を実行します：
- xが
NaN なら、NaN を返す。 - xの符号を反転したNumber値（絶対値は同じで符号が逆）を返す。
6.1.6.1.2 Number::bitwiseNOT ( x )
抽象操作Number::bitwiseNOTは、引数x（Number型）を受け取り、
6.1.6.1.3 Number::exponentiate ( base, exponent )
抽象操作Number::exponentiateは、引数base（Number型）とexponent（Number型）を受け取り、Number型を返します。baseのexponent乗の結果を表す
- exponentが
NaN ならNaN を返す。 - exponentが
+0 𝔽または-0 𝔽なら、1 𝔽を返す。 - baseが
NaN ならNaN を返す。 - baseが
+∞ 𝔽なら、- exponent >
+0 𝔽なら+∞ 𝔽を、そうでなければ+0 𝔽を返す。
- exponent >
- baseが
-∞ 𝔽なら、 - baseが
+0 𝔽なら、- exponent >
+0 𝔽なら+0 𝔽を、そうでなければ+∞ 𝔽を返す。
- exponent >
- baseが
-0 𝔽なら、 Assert : baseは有限 で、+0 𝔽でも-0 𝔽でもない。- exponentが
+∞ 𝔽なら、 - exponentが
-∞ 𝔽なら、 Assert : exponentは有限 で、+0 𝔽でも-0 𝔽でもない。- base <
-0 𝔽かつexponentが整数型Number でなければ、NaN を返す。 実装近似値 のNumber値（ℝ (base)のℝ (exponent)乗）を返す。
baseが** exponentの結果は、
6.1.6.1.4 Number::multiply ( x, y )
抽象操作Number::multiplyは、引数x（Number型）、y（Number型）を受け取り、Number型を返します。
6.1.6.1.5 Number::divide ( x, y )
抽象操作Number::divideは、引数x（Number型）、y（Number型）を受け取り、Number型を返します。
- xが
NaN またはyがNaN なら、NaN を返す。 - xが
+∞ 𝔽または-∞ 𝔽なら、- yが
+∞ 𝔽または-∞ 𝔽なら、NaN を返す。 - yが
+0 𝔽またはy >+0 𝔽ならxを返す。 - それ以外は-xを返す。
- yが
- yが
+∞ 𝔽なら、- xが
+0 𝔽またはx >+0 𝔽なら+0 𝔽を返す。そうでなければ-0 𝔽を返す。
- xが
- yが
-∞ 𝔽なら、- xが
+0 𝔽またはx >+0 𝔽なら-0 𝔽を返す。そうでなければ+0 𝔽を返す。
- xが
- xが
+0 𝔽または-0 𝔽なら、- yが
+0 𝔽または-0 𝔽なら、NaN を返す。 - y >
+0 𝔽ならxを返す。 - それ以外は-xを返す。
- yが
- yが
+0 𝔽なら、- x >
+0 𝔽なら+∞ 𝔽を返す。そうでなければ-∞ 𝔽を返す。
- x >
- yが
-0 𝔽なら、- x >
+0 𝔽なら-∞ 𝔽を返す。そうでなければ+∞ 𝔽を返す。
- x >
𝔽 (ℝ (x) /ℝ (y))を返す。
6.1.6.1.6 Number::remainder ( n, d )
抽象操作Number::remainderは、引数n（Number型）、d（Number型）を受け取り、Number型を返します。ここでnは被除数、dは除数であり、暗黙の除算から余りを返します。呼び出し時、次の手順を実行します：
CやC++では余り演算子は整数オペランドのみ受け付けますが、ECMAScriptでは浮動小数点オペランドも受け付けます。
%演算子で計算される）は、%の挙動を定義しています。これはCライブラリ関数fmodと比較できます。
6.1.6.1.7 Number::add ( x, y )
抽象操作Number::addは、引数x（Number型）、y（Number型）を受け取り、Number型を返します。
6.1.6.1.8 Number::subtract ( x, y )
抽象操作Number::subtractは、引数x（Number型）、y（Number型）を受け取り、Number型を返します。減算を行い、被減数xから減数yを引いた差を返します。呼び出し時、次の手順を実行します：
Number::add (x,Number::unaryMinus (y))を返す。
常にx - yはx + (-y)と同じ結果を生成します。
6.1.6.1.9 Number::leftShift ( x, y )
抽象操作Number::leftShiftは、引数x（Number型）、y（Number型）を受け取り、
6.1.6.1.10 Number::signedRightShift ( x, y )
抽象操作Number::signedRightShiftは、引数x（Number型）、y（Number型）を受け取り、
6.1.6.1.11 Number::unsignedRightShift ( x, y )
抽象操作Number::unsignedRightShiftは、引数x（Number型）、y（Number型）を受け取り、
6.1.6.1.12 Number::lessThan ( x, y )
抽象操作Number::lessThanは、引数x（Number型）、y（Number型）を受け取り、Booleanまたは
6.1.6.1.13 Number::equal ( x, y )
抽象操作Number::equalは、引数x（Number型）、y（Number型）を受け取り、Booleanを返します。呼び出し時、次の手順を実行します：
- xが
NaN ならfalse を返す。 - yが
NaN ならfalse を返す。 - xがyと等しければ
true を返す。 - xが
+0 𝔽かつyが-0 𝔽ならtrue を返す。 - xが
-0 𝔽かつyが+0 𝔽ならtrue を返す。 false を返す。
6.1.6.1.14 Number::sameValue ( x, y )
抽象操作Number::sameValueは、引数x（Number型）、y（Number型）を受け取り、Booleanを返します。呼び出し時、次の手順を実行します：
- xが
NaN かつyがNaN ならtrue を返す。 - xが
+0 𝔽かつyが-0 𝔽ならfalse を返す。 - xが
-0 𝔽かつyが+0 𝔽ならfalse を返す。 - xがyと等しければ
true を返す。 false を返す。
6.1.6.1.15 Number::sameValueZero ( x, y )
抽象操作Number::sameValueZeroは、引数x（Number型）、y（Number型）を受け取り、Booleanを返します。呼び出し時、次の手順を実行します：
- xが
NaN かつyがNaN ならtrue を返す。 - xが
+0 𝔽かつyが-0 𝔽ならtrue を返す。 - xが
-0 𝔽かつyが+0 𝔽ならtrue を返す。 - xがyと等しければ
true を返す。 false を返す。
6.1.6.1.16 NumberBitwiseOp ( op, x, y )
抽象操作NumberBitwiseOpは、引数op（&、^、|）、x（Number型）、y（Number型）を受け取り、
- lNumを!
ToInt32 (x)とする。 - rNumを!
ToInt32 (y)とする。 - lBitsを
ℝ (lNum)を表す32ビット2の補数ビット列とする。 - rBitsを
ℝ (rNum)を表す32ビット2の補数ビット列とする。 - opが
&なら、- resultをlBitsとrBitsにビットAND演算を適用した結果とする。
- そうでなくopが
^なら、- resultをlBitsとrBitsにビット排他的OR（XOR）演算を適用した結果とする。
- それ以外の場合、
Assert : opは|である。- resultをlBitsとrBitsにビットOR演算を適用した結果とする。
- resultで表される32ビット2の補数ビット列の
整数 に対応するNumber値 を返す。
6.1.6.1.17 Number::bitwiseAND ( x, y )
抽象操作Number::bitwiseANDは、引数x（Number型）、y（Number型）を受け取り、
NumberBitwiseOp (&, x, y)を返す。
6.1.6.1.18 Number::bitwiseXOR ( x, y )
抽象操作Number::bitwiseXORは、引数x（Number型）、y（Number型）を受け取り、
NumberBitwiseOp (^, x, y)を返す。
6.1.6.1.19 Number::bitwiseOR ( x, y )
抽象操作Number::bitwiseORは、引数x（Number型）、y（Number型）を受け取り、
NumberBitwiseOp (|, x, y)を返す。
6.1.6.1.20 Number::toString ( x, radix )
抽象操作Number::toStringは、引数x（Number型）、radix（
- xが
NaN なら"NaN" を返す。 - xが
+0 𝔽または-0 𝔽なら"0" を返す。 - x <
-0 𝔽なら、文字列連結 で"-" とNumber::toString (-x, radix)を連結して返す。 - xが
+∞ 𝔽なら"Infinity" を返す。 -
n、k、sを
整数 とし、k ≥ 1、radixk - 1 ≤ s < radixk、𝔽 (s × radixn - k)がxで、kが最小。kは基数radixで表現したsの桁数で、sはradixで割り切れず、最下位の桁は一意とは限らないことに注意。 - radix ≠ 10またはnが
-5から21の包含区間 なら、 - この場合、入力は科学的E表記（例：
1.2e+3）で表現される。 Assert : radixは10。- n < 0なら、
- exponentSignをコード単位0x002D（HYPHEN-MINUS）とする。
- それ以外、
- exponentSignをコード単位0x002B（PLUS SIGN）とする。
- k = 1なら、
- 最上位の10進桁のコード単位、コード単位0x002E（FULL STOP）、残りk -
1桁の10進表現のコード単位、コード単位0x0065（LATIN SMALL LETTER
E）、exponentSign、
abs (n - 1)の10進表現のコード単位を文字列連結 して返す。
ECMAScriptの実装者にはDavid M. Gayが書いた浮動小数点数の2進-10進変換の論文とコードが有用かもしれません：
Gay, David M. Correctly Rounded Binary-Decimal and Decimal-Binary Conversions.
Numerical Analysis, Manuscript 90-10. AT&T Bell Laboratories (Murray Hill,
New Jersey). 1990年11月30日。
https://ampl.com/_archive/first-website/REFS/rounding.pdf。
関連コードは
http://netlib.sandia.gov/fp/dtoa.c
および
http://netlib.sandia.gov/fp/g_fmt.c
にあり、他のnetlibミラーサイトにもあります。
6.1.6.2 BigInt型
BigInt型は、
6.1.6.2.1 BigInt::unaryMinus ( x )
抽象操作BigInt::unaryMinusは引数x（BigInt型）を受け取り、BigInt型を返します。呼び出し時、次の手順を実行します：
- x =
0 ℤなら0 ℤを返す。 - -xを返す。
6.1.6.2.2 BigInt::bitwiseNOT ( x )
抽象操作BigInt::bitwiseNOTは引数x（BigInt型）を受け取り、BigInt型を返します。xの1の補数を返します。呼び出し時、次の手順を実行します：
- -x -
1 ℤを返す。
6.1.6.2.3 BigInt::exponentiate ( base, exponent )
抽象操作BigInt::exponentiateは引数base（BigInt型）、exponent（BigInt型）を受け取り、
- exponent <
0 ℤならRangeError 例外を投げる。 - base =
0 ℤかつexponent =0 ℤなら1 ℤを返す。 - baseのexponent乗を返す。
6.1.6.2.4 BigInt::multiply ( x, y )
抽象操作BigInt::multiplyは引数x（BigInt型）、y（BigInt型）を受け取り、BigInt型を返します。呼び出し時、次の手順を実行します：
- x × yを返す。
6.1.6.2.5 BigInt::divide ( x, y )
抽象操作BigInt::divideは引数x（BigInt型）、y（BigInt型）を受け取り、
6.1.6.2.6 BigInt::remainder ( n, d )
抽象操作BigInt::remainderは引数n（BigInt型）、d（BigInt型）を受け取り、
6.1.6.2.7 BigInt::add ( x, y )
抽象操作BigInt::addは引数x（BigInt型）、y（BigInt型）を受け取り、BigInt型を返します。呼び出し時、次の手順を実行します：
- x + yを返す。
6.1.6.2.8 BigInt::subtract ( x, y )
抽象操作BigInt::subtractは引数x（BigInt型）、y（BigInt型）を受け取り、BigInt型を返します。呼び出し時、次の手順を実行します：
- x - yを返す。
6.1.6.2.9 BigInt::leftShift ( x, y )
抽象操作BigInt::leftShiftは引数x（BigInt型）、y（BigInt型）を受け取り、BigInt型を返します。呼び出し時、次の手順を実行します：
6.1.6.2.10 BigInt::signedRightShift ( x, y )
抽象操作BigInt::signedRightShiftは引数x（BigInt型）、y（BigInt型）を受け取り、BigInt型を返します。呼び出し時、次の手順を実行します：
BigInt::leftShift (x, -y)を返す。
6.1.6.2.11 BigInt::unsignedRightShift ( x, y )
抽象操作BigInt::unsignedRightShiftは引数x（BigInt型）、y（BigInt型）を受け取り、
TypeError 例外を投げる。
6.1.6.2.12 BigInt::lessThan ( x, y )
抽象操作BigInt::lessThanは引数x（BigInt型）、y（BigInt型）を受け取り、Boolean型を返します。呼び出し時、次の手順を実行します：
6.1.6.2.13 BigInt::equal ( x, y )
抽象操作BigInt::equalは引数x（BigInt型）、y（BigInt型）を受け取り、Boolean型を返します。呼び出し時、次の手順を実行します：
6.1.6.2.14 BinaryAnd ( x, y )
抽象操作BinaryAndは引数x（0または1）、y（0または1）を受け取り、0または1を返します。呼び出し時、次の手順を実行します：
- x = 1かつy = 1なら1を返す。
- それ以外は0を返す。
6.1.6.2.15 BinaryOr ( x, y )
抽象操作BinaryOrは引数x（0または1）、y（0または1）を受け取り、0または1を返します。呼び出し時、次の手順を実行します：
- x = 1またはy = 1なら1を返す。
- それ以外は0を返す。
6.1.6.2.16 BinaryXor ( x, y )
抽象操作BinaryXorは引数x（0または1）、y（0または1）を受け取り、0または1を返します。呼び出し時、次の手順を実行します：
- x = 1かつy = 0なら1を返す。
- それ以外でx = 0かつy = 1なら1を返す。
- それ以外は0を返す。
6.1.6.2.17 BigIntBitwiseOp ( op, x, y )
抽象操作BigIntBitwiseOpは、引数op（&、^、|）、x（BigInt型）、y（BigInt型）を受け取り、BigInt型を返します。呼び出し時、次の手順を実行します：
- xを
ℝ (x)に設定する。 - yを
ℝ (y)に設定する。 - resultを0に設定する。
- shiftを0に設定する。
- 次を満たすまで繰り返す：（x = 0またはx = -1）かつ（y = 0またはy = -1）
- opが
&なら、 - それ以外でopが
|なら、 - それ以外の場合、
- tmp ≠ 0なら、
- resultをresult - 2shiftに設定する。
- 注：これは符号拡張を行います。
- resultの
BigInt値 を返す。
6.1.6.2.18 BigInt::bitwiseAND ( x, y )
抽象操作BigInt::bitwiseANDは引数x（BigInt型）、y（BigInt型）を受け取り、BigInt型を返します。呼び出し時、次の手順を実行します：
BigIntBitwiseOp (&, x, y)を返す。
6.1.6.2.19 BigInt::bitwiseXOR ( x, y )
抽象操作BigInt::bitwiseXORは引数x（BigInt型）、y（BigInt型）を受け取り、BigInt型を返します。呼び出し時、次の手順を実行します：
BigIntBitwiseOp (^, x, y)を返す。
6.1.6.2.20 BigInt::bitwiseOR ( x, y )
抽象操作BigInt::bitwiseORは引数x（BigInt型）、y（BigInt型）を受け取り、BigInt型を返します。呼び出し時、次の手順を実行します：
BigIntBitwiseOp (|, x, y)を返す。
6.1.6.2.21 BigInt::toString ( x, radix )
抽象操作BigInt::toStringは引数x（BigInt型）、radix（
- x <
0 ℤなら、文字列連結 で"-" とBigInt::toString (-x, radix)を連結して返す。 - 基数radixで表現したxのString値を返す。
6.1.7 オブジェクト型
Object型の各インスタンス（単に「オブジェクト」とも呼ばれる）は、プロパティの集合を表します。各プロパティはデータプロパティまたはアクセサプロパティのいずれかです：
-
データプロパティは、キー値を
ECMAScript言語値 とBoolean属性の集合に関連付けます。 -
アクセサプロパティは、キー値を1つまたは2つのアクセサ関数とBoolean属性の集合に関連付けます。アクセサ関数は、そのプロパティに関連付けられた
ECMAScript言語値 の格納や取得に使われます。
オブジェクトのプロパティは
整数インデックスは、
すべてのオブジェクトは論理的にプロパティの集合ですが、プロパティのアクセスや操作の意味論が異なる複数の形式のオブジェクトが存在します。詳細は
さらに、一部のオブジェクトは呼び出し可能であり、これらは関数または
6.1.7.1 プロパティ属性
属性は、この仕様でObjectプロパティの状態を定義・説明するために使用されます（
| 属性名 | 属性が存在するプロパティの種類 | 値のドメイン | デフォルト値 | 説明 |
|---|---|---|---|---|
| [[Value]] |
|
|
|
getアクセスで取得されるプロパティの値。 |
| [[Writable]] |
|
Boolean |
|
|
| [[Get]] |
|
Object または |
|
値が |
| [[Set]] |
|
Object または |
|
値が |
| [[Enumerable]] |
|
Boolean |
|
|
| [[Configurable]] |
|
Boolean |
|
|
6.1.7.2 オブジェクトの内部メソッドと内部スロット
ECMAScriptにおけるオブジェクトの実際の意味論は、内部メソッドと呼ばれるアルゴリズムによって規定されます。ECMAScriptエンジンの各オブジェクトには、その実行時の挙動を定義する内部メソッドの集合が関連付けられています。これらの内部メソッドはECMAScript言語の一部ではありません。本仕様で説明目的のみで定義されます。ただし、ECMAScriptの各実装におけるオブジェクトは、その関連付けられた内部メソッドで規定されたとおりに動作しなければなりません。その実現方法の詳細は実装によって決まります。
内部メソッド名はポリモーフィックです。つまり、同じ内部メソッド名を呼び出しても、異なるオブジェクト値ごとに異なるアルゴリズムが実行される場合があります。内部メソッドが呼び出される実際のオブジェクトを「ターゲット」と呼びます。実行時に、あるアルゴリズムがオブジェクトのサポートしない内部メソッドを使おうとした場合、
内部スロットは、オブジェクトに関連付けられ、ECMAScript仕様のさまざまなアルゴリズムで使われる内部状態を表します。内部スロットはオブジェクトのプロパティではなく、継承もされません。各内部スロット仕様によっては、その状態はどの
すべてのオブジェクトには[[PrivateElements]]という名前の内部スロットがあり、これは
内部メソッドと内部スロットは、この仕様では[[ ]]で囲まれた名前で示されます。
通常のオブジェクトとは、次の条件をすべて満たすオブジェクトです：
-
表4 に挙げた内部メソッドについて、そのオブジェクトは10.1 で定義されたものを使う。 -
オブジェクトが[[Call]]内部メソッドを持つ場合、それは
10.2.1 または10.3.1 で定義されたもののいずれかを使う。 -
オブジェクトが[[Construct]]内部メソッドを持つ場合、それは
10.2.2 または10.3.2 で定義されたもののいずれかを使う。
エキゾチックオブジェクトとは、
本仕様では、
内部メソッドは、パラメータに加えて、常に呼び出し対象のオブジェクト自身にアクセスできます。
内部メソッドは暗黙的に
| 内部メソッド | シグネチャ | 説明 |
|---|---|---|
| [[GetPrototypeOf]] | ( ) → Object | Null |
このオブジェクトに継承プロパティを提供するオブジェクトを決定する。 |
| [[SetPrototypeOf]] | (Object | Null) → Boolean |
このオブジェクトに継承プロパティを提供する別のオブジェクトを関連付ける。 |
| [[IsExtensible]] | ( ) → Boolean | このオブジェクトに追加プロパティを追加できるかどうかを判定する。 |
| [[PreventExtensions]] | ( ) → Boolean |
このオブジェクトに新たなプロパティを追加できるかどうかを制御する。操作が成功したら |
| [[GetOwnProperty]] |
(propertyKey) → Undefined | |
このオブジェクトの所有プロパティでキーがpropertyKeyであるものについて、 |
| [[DefineOwnProperty]] | (propertyKey, PropertyDescriptor) → Boolean |
キーがpropertyKeyの所有プロパティをPropertyDescriptorで記述される状態に新規作成または変更する。プロパティの作成・更新に成功した場合は |
| [[HasProperty]] | (propertyKey) → Boolean | このオブジェクトが既に所有または継承するキーpropertyKeyのプロパティを持つかどうかを示すBoolean値を返す。 |
| [[Get]] | (propertyKey, Receiver) → any |
このオブジェクトからキーpropertyKeyのプロパティ値を返す。プロパティ値の取得にECMAScriptコードの実行が必要な場合、Receiverが |
| [[Set]] | (propertyKey, value, Receiver) → Boolean |
このオブジェクトのキーpropertyKeyのプロパティ値をvalueに設定する。値の設定にECMAScriptコードの実行が必要な場合、Receiverが |
| [[Delete]] | (propertyKey) → Boolean |
このオブジェクトからキーpropertyKeyの所有プロパティを削除する。削除できなかった場合（まだ存在する場合）は |
| [[OwnPropertyKeys]] |
( ) → |
オブジェクトのすべての所有 |
| 内部メソッド | シグネチャ | 説明 |
|---|---|---|
| [[Call]] |
(any, |
このオブジェクトに関連するコードを実行する。関数呼び出し式を介して呼び出される。内部メソッドの引数は |
| [[Construct]] |
( |
オブジェクトを生成する。new演算子またはsuper呼び出しで呼ばれる。内部メソッドの第1引数はsuper呼び出しの引数を要素とするnew演算子が最初に適用されたオブジェクト。これを実装するオブジェクトは |
6.1.7.3 本質的内部メソッドの不変条件
ECMAScriptエンジンのオブジェクトの内部メソッドは、以下に指定する不変条件を満たさなければなりません。本仕様の通常のECMAScriptオブジェクトおよびすべての標準
実装で提供される
実装は、必須内部メソッドの機能を不変条件を強制せずに別のインターフェースで提供するといった手段で、これらの不変条件を回避できるようにしてはなりません。
定義:
- 内部メソッドのターゲットとは、その内部メソッドが呼び出されるオブジェクトです。
-
ターゲットの[[IsExtensible]]内部メソッドが
false を返した、または[[PreventExtensions]]内部メソッドがtrue を返したことが観測された場合、ターゲットは拡張不可（non-extensible）です。 - 存在しない（non-existent）プロパティとは、拡張不可ターゲットの所有プロパティとして存在しないプロパティです。
-
SameValue へのすべての参照は、SameValue アルゴリズムの定義によります。
戻り値:
いかなる内部メソッドが返す値も、以下のいずれかの
- [[Type]] =
normal 、[[Target]] =empty 、[[Value]] = 下記に示すその内部メソッドの「通常の戻り値型」の値、または - [[Type]] =
throw 、[[Target]] =empty 、[[Value]] = 任意のECMAScript言語値 。
内部メソッドは
[[GetPrototypeOf]] ( )
- 通常の戻り値型はObjectまたはNullです。
-
ターゲットが拡張不可で[[GetPrototypeOf]]が値Vを返した場合、以後の[[GetPrototypeOf]]呼び出しも
SameValue としてVを返すべきです。
オブジェクトのプロトタイプチェーンは
[[SetPrototypeOf]] ( V )
- 通常の戻り値型はBooleanです。
-
ターゲットが拡張不可の場合、Vがターゲットの観測された[[GetPrototypeOf]]値と
SameValue でない限り、[[SetPrototypeOf]]はfalse を返さなければなりません。
[[IsExtensible]] ( )
- 通常の戻り値型はBooleanです。
-
[[IsExtensible]]が
false を返した場合、それ以降のターゲットへの[[IsExtensible]]呼び出しはすべてfalse を返さなければなりません。
[[PreventExtensions]] ( )
- 通常の戻り値型はBooleanです。
-
[[PreventExtensions]]が
true を返した場合、それ以降のターゲットへの[[IsExtensible]]呼び出しはすべてfalse を返し、ターゲットは拡張不可とみなされます。
[[GetOwnProperty]] ( P )
-
通常の戻り値型は
Property Descriptor またはUndefinedです。 -
戻り値が
Property Descriptor の場合、それは完全なProperty Descriptor でなければなりません。 -
Pが非設定可能かつ非書換可能な所有
データプロパティ である場合、以後の[[GetOwnProperty]](P)呼び出しは、[[Value]]がSameValue でPの[[Value]]属性と一致するProperty Descriptor を返さなければなりません。 -
Pの[[Writable]]・[[Value]]以外の属性が将来変更される、またはプロパティが削除される可能性がある場合、[[Configurable]]属性は
true でなければなりません。 -
[[Writable]]属性が
false からtrue に将来変更される可能性がある場合、[[Configurable]]属性はtrue でなければなりません。 -
ターゲットが拡張不可でPが存在しない場合、以後のターゲットへの[[GetOwnProperty]](P)呼び出しはPが存在しないものとして記述しなければなりません（つまり[[GetOwnProperty]](P)は
undefined を返さなければなりません）。
第3不変条件の帰結として、プロパティが
[[DefineOwnProperty]] ( P, Desc )
- 通常の戻り値型はBooleanです。
-
[[DefineOwnProperty]]は、Pが以前に非設定可能な所有プロパティとして観測されていた場合、次のいずれかを除き
false を返さなければなりません： -
[[DefineOwnProperty]](P,
Desc)は、ターゲットが拡張不可かつPが存在しない所有プロパティの場合
false を返さなければなりません。つまり、拡張不可なターゲットオブジェクトは新たなプロパティで拡張できません。
[[HasProperty]] ( P )
- 通常の戻り値型はBooleanです。
-
Pが以前にターゲットの非設定可能な所有データまたは
アクセサプロパティ として観測されていた場合、[[HasProperty]]はtrue を返さなければなりません。
[[Get]] ( P, Receiver )
-
通常の戻り値型は
ECMAScript言語型 です。 -
Pが以前にターゲットの非設定可能・非書換可能な所有
データプロパティ で値Vを持つと観測されていた場合、[[Get]]はVとSameValue な値を返さなければなりません。 -
Pが以前にターゲットの非設定可能な所有
アクセサプロパティ で、その[[Get]]属性がundefined だった場合、[[Get]]操作はundefined を返さなければなりません。
[[Set]] ( P, V, Receiver )
- 通常の戻り値型はBooleanです。
-
Pが以前にターゲットの非設定可能・非書換可能な所有
データプロパティ であった場合、[[Set]]はVがPの[[Value]]属性とSameValue でない限りfalse を返さなければなりません。 -
Pが以前にターゲットの非設定可能な所有
アクセサプロパティ で、その[[Set]]属性がundefined だった場合、[[Set]]操作はfalse を返さなければなりません。
[[Delete]] ( P )
- 通常の戻り値型はBooleanです。
-
Pが以前にターゲットの非設定可能な所有データまたは
アクセサプロパティ であった場合、[[Delete]]はfalse を返さなければなりません。
[[OwnPropertyKeys]] ( )
-
通常の戻り値型は
List です。 -
返される
List には重複要素があってはなりません。 -
返される
List の各要素は、プロパティキー でなければなりません。 -
返される
List には、これまでに観測されたすべての非設定可能な所有プロパティのキーが少なくとも含まれていなければなりません。 -
ターゲットが拡張不可の場合、返される
List には[[GetOwnProperty]]で観測可能なターゲットのすべての所有プロパティのキーのみが含まれていなければなりません。
[[Call]] ( )
-
通常の戻り値型は
ECMAScript言語型 です。
[[Construct]] ( )
- 通常の戻り値型はObjectです。
- ターゲットは[[Call]]内部メソッドも持っていなければなりません。
6.1.7.4 よく知られた組み込みオブジェクト
よく知られた組み込みオブジェクトは、この仕様書のアルゴリズムで明示的に参照される組み込みオブジェクトであり、通常は
この仕様書内では、%name% のような参照は、現在の
追加の項目は
6.2 ECMAScript 仕様タイプ
仕様タイプは、アルゴリズム内で ECMAScript 言語構成要素および
6.2.1 Enum 仕様タイプ
Enum は仕様内部でのみ使用され、ECMAScript コードから直接観測できない値です。Enum
は
6.2.2 List および Record 仕様タイプ
List 型は、new
式、関数呼び出し、その他のアルゴリズムで引数リスト（
アルゴリズムが List の要素を順序を明示せずに反復する場合、その順序は List の要素順です。
この仕様内では、リテラル構文で新しい List 値を表現できます。例えば、« 1, 2 » は 2 つの要素を持つ List 値を表し、それぞれ特定の値で初期化されます。新しい空の List は « » で表現できます。
この仕様書では、「A, B, ... の list-concatenation」という表現（各引数は空の場合もある List）で、各引数の要素を（順に）連結した新しい List 値を意味します。
List of Strings に対して、「辞書式コードユニット順でソートする」とは、短い方の文字列の長さまで各コードユニットの数値値でソートし、すべて等しい場合は短い文字列を先に並べることを意味します。これは抽象操作
Record 型は、この仕様のアルゴリズム内でデータの集約を記述するために使用されます。Record
型の値は 1 つ以上の名前付きフィールドからなります。各フィールドの値は
この仕様内ではオブジェクトリテラル風の構文で Record 値を表現できます。たとえば、{ [[Field1]]: 42, [[Field2]]:
仕様テキストやアルゴリズムでは、Record 値の特定のフィールドを参照するためにドット記法を使うことがあります。たとえば、前述の R というレコードに対して R.[[Field2]] は「R の [[Field2]] という名前のフィールド」を意味します。
よく使われる Record フィールドの組み合わせのスキーマには名前を付けることができ、その名前をリテラル Record
値の前に付与して、どの種類の集約が記述されているかを明示できます。例：PropertyDescriptor { [[Value]]: 42,
[[Writable]]:
6.2.3 Set および Relation 仕様タイプ
Set 型は、
Relation 型は、Set 上の制約を説明するために使われます。Relation 型の値は、その値領域の順序付きペアの Set です。たとえば、イベント上の Relation はイベントの順序付きペアの集合です。Relation R およびその値領域内の 2 つの値 a、b に対し、a R b は順序付きペア (a, b) が R の要素であることを略記しています。Relation は、ある条件に対してそれを満たす最小の Relation（最小 Relation）である場合、その条件に関する最小の Relation です。
狭義半順序(strict partial order) とは、Relation 値 R が次を満たすことです。
-
すべての a, b, c（R のドメイン内）について:
- a R a は成り立たない（反射性なし）
- a R b かつ b R c ならば a R c（推移性）
上記2つの性質は、それぞれ反射性なし(irreflexivity)・推移性(transitivity)と呼ばれます。
狭義全順序(strict total order) とは、Relation 値 R が次を満たすことです。
-
すべての a, b, c（R のドメイン内）について:
- a は b であるか、a R b か、b R a のいずれかである（全順序性）
- a R a は成り立たない（反射性なし）
- a R b かつ b R c ならば a R c（推移性）
上記3つの性質は、それぞれ全順序性(totality)・反射性なし(irreflexivity)・推移性(transitivity)と呼ばれます。
6.2.4 完了レコード仕様タイプ
Completion Record
仕様タイプは、値のランタイム伝播や、break、continue、return、throw
など、制御の非局所的な移動を行う文の動作など、制御フローを説明するために用いられます。
Completion Record には
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Type]] |
|
発生した完了の種類。 |
| [[Value]] |
|
生成された値。 |
| [[Target]] |
文字列または |
指定された制御移動のターゲットラベル。 |
Completion Record を指すために、以下のような略語が使われることがあります。
- normal completion は、[[Type]] の値が
normal である Completion Record を指します。 - break completion は、[[Type]] の値が
break である Completion Record を指します。 - continue completion は、[[Type]] の値が
continue である Completion Record を指します。 - return completion は、[[Type]] の値が
return である Completion Record を指します。 - throw completion は、[[Type]] の値が
throw である Completion Record を指します。 - abrupt completion は、[[Type]] の値が
normal 以外である Completion Record を指します。 - normal completion containing ある型の値を含む normal completion とは、その型の値が [[Value]] フィールドにある normal completion を指します。
この仕様で定義される呼び出し可能オブジェクトは、normal completion または throw completion のみを返します。それ以外の Completion Record を返すことは編集上の誤りとみなされます。
6.2.4.1 NormalCompletion ( value )
抽象操作 NormalCompletion は、引数 value（
Completion Record { [[Type]]:normal , [[Value]]: value, [[Target]]:empty } を返す。
6.2.4.2 ThrowCompletion ( value )
抽象操作 ThrowCompletion は、引数 value（
Completion Record { [[Type]]:throw , [[Value]]: value, [[Target]]:empty } を返す。
6.2.4.3 ReturnCompletion ( value )
抽象操作 ReturnCompletion は、引数 value（
Completion Record { [[Type]]:return , [[Value]]: value, [[Target]]:empty } を返す。
6.2.4.4 UpdateEmpty ( completionRecord, value )
抽象操作 UpdateEmpty は、引数 completionRecord（
アサート : completionRecord がreturn completion またはthrow completion のいずれかである場合、completionRecord.[[Value]] はempty であってはならない。- もし completionRecord.[[Value]] が
empty でなければ、? completionRecord を返す。 Completion Record { [[Type]]: completionRecord.[[Type]], [[Value]]: value, [[Target]]: completionRecord.[[Target]] } を返す。
6.2.5 参照レコード仕様タイプ
Reference Record
型は、delete、typeof、代入演算子、super
Reference Record は解決された名前または（まだ解決されていないかもしれない）プロパティバインディングであり、そのフィールドは
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Base]] | バインディングを保持している値または |
|
| [[ReferencedName]] | バインディングの名前。[[Base]] の値が |
|
| [[Strict]] | Boolean | |
| [[ThisValue]] | super |
この仕様で参照レコードを操作するために、以下の
6.2.5.1 IsPropertyReference ( V )
抽象操作 IsPropertyReference は、引数 V（
- もし V.[[Base]] が
unresolvable なら、false を返す。 - もし V.[[Base]] が
Environment Record ならfalse を返し、それ以外ならtrue を返す。
6.2.5.2 IsUnresolvableReference ( V )
抽象操作 IsUnresolvableReference は、引数 V（
- もし V.[[Base]] が
unresolvable ならtrue を返し、それ以外ならfalse を返す。
6.2.5.3 IsSuperReference ( V )
抽象操作 IsSuperReference は、引数 V（
- もし V.[[ThisValue]] が
empty でなければtrue を返し、それ以外ならfalse を返す。
6.2.5.4 IsPrivateReference ( V )
抽象操作 IsPrivateReference は、引数 V（
- もし V.[[ReferencedName]] が
Private Name であればtrue を返し、それ以外ならfalse を返す。
6.2.5.5 GetValue ( V )
抽象操作 GetValue は、引数 V（
- もし V が
Reference Record でなければ、V を返す。 IsUnresolvableReference (V) がtrue なら、ReferenceError 例外をスローする。IsPropertyReference (V) がtrue なら、- baseObj を ?
ToObject (V.[[Base]]) とする。 IsPrivateReference (V) がtrue なら、- ?
PrivateGet (baseObj, V.[[ReferencedName]]) を返す。
- ?
- V.[[ReferencedName]] が
property key でなければ、- V.[[ReferencedName]] を
?
ToPropertyKey (V.[[ReferencedName]]) とする。
- V.[[ReferencedName]] を
?
- ? baseObj.[[Get]](V.[[ReferencedName]],
GetThisValue (V)) を返す。
- baseObj を ?
- それ以外の場合、
- base を V.[[Base]] とする。
アサート : base はEnvironment Record である。- ? base.GetBindingValue(V.[[ReferencedName]], V.[[Strict]]) を返す（
9.1 参照）。
6.2.5.6 PutValue ( V, W )
抽象操作 PutValue は、引数 V（
- もし V が
Reference Record でなければ、ReferenceError 例外をスローする。 IsUnresolvableReference (V) がtrue なら、- もし V.[[Strict]] が
true なら、ReferenceError 例外をスローする。 - globalObj を
GetGlobalObject () とする。 - ?
Set (globalObj, V.[[ReferencedName]], W,false ) を実行する。 unused を返す。
- もし V.[[Strict]] が
IsPropertyReference (V) がtrue なら、- baseObj を ?
ToObject (V.[[Base]]) とする。 IsPrivateReference (V) がtrue なら、- ?
PrivateSet (baseObj, V.[[ReferencedName]], W) を返す。
- ?
- V.[[ReferencedName]] が
property key でなければ、- V.[[ReferencedName]] を
?
ToPropertyKey (V.[[ReferencedName]]) とする。
- V.[[ReferencedName]] を
?
- succeeded を ? baseObj.[[Set]](V.[[ReferencedName]], W,
GetThisValue (V)) とする。 - もし succeeded が
false かつ V.[[Strict]] がtrue なら、TypeError 例外をスローする。 unused を返す。
- baseObj を ?
- それ以外の場合、
- base を V.[[Base]] とする。
アサート : base はEnvironment Record である。- ? base.SetMutableBinding(V.[[ReferencedName]], W, V.[[Strict]]) を返す（
9.1 参照）。
6.2.5.7 GetThisValue ( V )
抽象操作 GetThisValue は、引数 V（
アサート :IsPropertyReference (V) がtrue であること。IsSuperReference (V) がtrue なら V.[[ThisValue]] を返し、そうでなければ V.[[Base]] を返す。
6.2.5.8 InitializeReferencedBinding ( V, W )
抽象操作 InitializeReferencedBinding は、引数 V（
アサート :IsUnresolvableReference (V) がfalse であること。- base を V.[[Base]] とする。
アサート : base はEnvironment Record であること。- ? base.InitializeBinding(V.[[ReferencedName]], W) を返す。
6.2.5.9 MakePrivateReference ( baseValue, privateIdentifier )
抽象操作 MakePrivateReference は、引数 baseValue（
- privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 アサート : privateEnv はnull であってはならない。- privateName を
ResolvePrivateIdentifier (privateEnv, privateIdentifier) とする。 - 次の
Reference Record を返す: { [[Base]]: baseValue, [[ReferencedName]]: privateName, [[Strict]]:true , [[ThisValue]]:empty }.
6.2.6 プロパティ記述子仕様タイプ
Property Descriptor
型は、オブジェクトプロパティ属性の操作および具現化を説明するために用いられます。Property Descriptor は、
Property Descriptor の値は、特定のフィールドの有無によってデータ Property Descriptor またはアクセサ Property Descriptor
に分類されることがあります。[[Value]] または [[Writable]]
という名前のフィールドが存在するものはデータ Property Descriptor です。[[Get]] または [[Set]] という名前のフィールドが存在するものはアクセサ Property Descriptor です。どの Property
Descriptor にも [[Enumerable]] および [[Configurable]] という名前のフィールドを持つことができます。Property Descriptor の値はデータ
Property Descriptor とアクセサ Property Descriptor の両方であってはなりませんが、どちらでもない場合もあります（この場合は汎用 Property
Descriptor です）。完全な Property Descriptor とは、アクセサ Property Descriptor
またはデータ Property Descriptor であり、かつ
この仕様で Property Descriptor の値を操作するために、以下の
6.2.6.1 IsAccessorDescriptor ( Desc )
抽象操作 IsAccessorDescriptor は、引数 Desc（
- もし Desc が [[Get]]
フィールドを持つなら、
true を返す。 - もし Desc が [[Set]]
フィールドを持つなら、
true を返す。 false を返す。
6.2.6.2 IsDataDescriptor ( Desc )
抽象操作 IsDataDescriptor は、引数 Desc（
- もし Desc が [[Value]]
フィールドを持つなら、
true を返す。 - もし Desc が [[Writable]]
フィールドを持つなら、
true を返す。 false を返す。
6.2.6.3 IsGenericDescriptor ( Desc )
抽象操作 IsGenericDescriptor は、引数 Desc（
IsAccessorDescriptor (Desc) がtrue なら、false を返す。IsDataDescriptor (Desc) がtrue なら、false を返す。true を返す。
6.2.6.4 FromPropertyDescriptor ( Desc )
抽象操作 FromPropertyDescriptor は、引数 Desc（
- もし Desc が
undefined なら、undefined を返す。 - obj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 アサート : obj は自身のプロパティを持たない拡張可能なordinary object である。- もし Desc が [[Value]] フィールドを持つなら：
- !
CreateDataPropertyOrThrow (obj,"value" , Desc.[[Value]]) を実行する。
- !
- もし Desc が [[Writable]] フィールドを持つなら：
- !
CreateDataPropertyOrThrow (obj,"writable" , Desc.[[Writable]]) を実行する。
- !
- もし Desc が [[Get]] フィールドを持つなら：
- !
CreateDataPropertyOrThrow (obj,"get" , Desc.[[Get]]) を実行する。
- !
- もし Desc が [[Set]] フィールドを持つなら：
- !
CreateDataPropertyOrThrow (obj,"set" , Desc.[[Set]]) を実行する。
- !
- もし Desc が [[Enumerable]] フィールドを持つなら：
- !
CreateDataPropertyOrThrow (obj,"enumerable" , Desc.[[Enumerable]]) を実行する。
- !
- もし Desc が [[Configurable]] フィールドを持つなら：
- !
CreateDataPropertyOrThrow (obj,"configurable" , Desc.[[Configurable]]) を実行する。
- !
- obj を返す。
6.2.6.5 ToPropertyDescriptor ( Obj )
抽象操作 ToPropertyDescriptor は、引数 Obj（
- もし Obj が
オブジェクトでない なら、TypeError 例外をスローする。 - desc を新しい
Property Descriptor （初期状態でフィールドなし）とする。 - hasEnumerable を ?
HasProperty (Obj,"enumerable" ) とする。 - もし hasEnumerable が
true なら： - hasConfigurable を ?
HasProperty (Obj,"configurable" ) とする。 - もし hasConfigurable が
true なら： - hasValue を ?
HasProperty (Obj,"value" ) とする。 - もし hasValue が
true なら：- value を ?
Get (Obj,"value" ) とする。 - desc.[[Value]] に value を設定する。
- value を ?
- hasWritable を ?
HasProperty (Obj,"writable" ) とする。 - もし hasWritable が
true なら： - hasGet を ?
HasProperty (Obj,"get" ) とする。 - もし hasGet が
true なら：- getter を ?
Get (Obj,"get" ) とする。 IsCallable (getter) がfalse かつ getter がundefined でなければ、TypeError 例外をスローする。- desc.[[Get]] に getter を設定する。
- getter を ?
- hasSet を ?
HasProperty (Obj,"set" ) とする。 - もし hasSet が
true なら：- setter を ?
Get (Obj,"set" ) とする。 IsCallable (setter) がfalse かつ setter がundefined でなければ、TypeError 例外をスローする。- desc.[[Set]] に setter を設定する。
- setter を ?
- もし desc が [[Get]] フィールドまたは [[Set]] フィールドを持つなら：
- もし desc が [[Value]] フィールドまたは [[Writable]] フィールドを持つなら、
TypeError 例外をスローする。
- もし desc が [[Value]] フィールドまたは [[Writable]] フィールドを持つなら、
- desc を返す。
6.2.6.6 CompletePropertyDescriptor ( Desc )
抽象操作 CompletePropertyDescriptor は、引数 Desc（
- like を
Record { [[Value]]:undefined , [[Writable]]:false , [[Get]]:undefined , [[Set]]:undefined , [[Enumerable]]:false , [[Configurable]]:false } とする。 IsGenericDescriptor (Desc) がtrue またはIsDataDescriptor (Desc) がtrue なら、- もし Desc が [[Value]] フィールドを持たないなら、Desc.[[Value]] に like.[[Value]] を設定する。
- もし Desc が [[Writable]] フィールドを持たないなら、Desc.[[Writable]] に like.[[Writable]] を設定する。
- それ以外の場合：
- もし Desc が [[Get]] フィールドを持たないなら、Desc.[[Get]] に like.[[Get]] を設定する。
- もし Desc が [[Set]] フィールドを持たないなら、Desc.[[Set]] に like.[[Set]] を設定する。
- もし Desc が [[Enumerable]] フィールドを持たないなら、Desc.[[Enumerable]] に like.[[Enumerable]] を設定する。
- もし Desc が [[Configurable]] フィールドを持たないなら、Desc.[[Configurable]] に like.[[Configurable]] を設定する。
unused を返す。
6.2.7 環境レコード仕様タイプ
6.2.8 抽象クロージャ仕様タイプ
Abstract Closure
仕様タイプは、アルゴリズムのステップと値の集合をまとめて参照するために用いられます。Abstract Closure
はメタ値であり、closure(arg1, arg2) のような関数適用スタイルで呼び出されます。
Abstract Closure を生成するアルゴリズムステップでは、「capture」に続いてエイリアスのリストが記載され、その値がキャプチャされます。Abstract Closure が生成されると、それぞれのエイリアスに対応する値をその時点でキャプチャします。Abstract Closure を呼び出したときに実行されるアルゴリズムを指定するステップでは、各キャプチャされた値はキャプチャ時に使われたエイリアスで参照されます。
Abstract Closure が
Abstract Closure は他のアルゴリズムの一部としてインラインで作成され、次の例のように示されます。
- addend を 41 とする。
- closure を、パラメータ (x) を持ち addend
をキャプチャし、呼び出されたときに次のステップを実行する新しい
Abstract Closure とする：- x + addend を返す。
- val を closure(1) とする。
アサート : val は 42 である。
6.2.9 データブロック
Data Block
仕様タイプは、個別かつ可変なバイト（8ビット）値のシーケンスを記述するために用いられます。byte
value とは、
この仕様内では、記法上の便宜のため、Data Block 値の個々のバイトにアクセスするために配列風の構文を使うことができます。この記法は、Data Block 値を 0
基点の
複数の
Shared Data Block のセマンティクスは、
この仕様で Data Block 値を操作するために、以下の
6.2.9.1 CreateByteDataBlock ( size )
抽象操作 CreateByteDataBlock は、引数 size（非負の
- もし size > 253 - 1 なら、
RangeError 例外をスローする。 - db を size バイトからなる新しい
Data Block 値とする。そのようなData Block を生成できない場合、RangeError 例外をスローする。 - db のすべてのバイトを 0 に設定する。
- db を返す。
6.2.9.2 CreateSharedByteDataBlock ( size )
抽象操作 CreateSharedByteDataBlock は、引数 size（非負の
- db を size バイトからなる新しい
Shared Data Block 値とする。そのようなShared Data Block を生成できない場合、RangeError 例外をスローする。 - execution を
周囲のエージェント のAgent Record の [[CandidateExecution]] フィールドとする。 - eventsRecord を execution.[[EventsRecords]] のうち、[[AgentSignifier]] が
AgentSignifier () であるAgent Events Record とする。 - zero を « 0 » とする。
- db の各インデックス i について、
WriteSharedMemory { [[Order]]:init , [[NoTear]]:true , [[Block]]: db, [[ByteIndex]]: i, [[ElementSize]]: 1, [[Payload]]: zero } を eventsRecord.[[EventList]] に追加する。
- db を返す。
6.2.9.3 CopyDataBlockBytes ( toBlock, toIndex, fromBlock, fromIndex, count )
抽象操作 CopyDataBlockBytes は、引数 toBlock（
アサート : fromBlock と toBlock は異なる値であること。- fromSize を fromBlock のバイト数とする。
アサート : fromIndex + count ≤ fromSize であること。- toSize を toBlock のバイト数とする。
アサート : toIndex + count ≤ toSize であること。- count > 0 の間、繰り返す：
- もし fromBlock が
Shared Data Block なら、- execution を
周囲のエージェント のAgent Record の [[CandidateExecution]] フィールドとする。 - eventsRecord を execution.[[EventsRecords]] のうち、[[AgentSignifier]] が
AgentSignifier () であるAgent Events Record とする。 - bytes を、唯一の要素が非決定的に選択された
byte value であるList とする。 - 注：実装において bytes は基盤ハードウェア上の非アトミックな読み取り命令の結果です。非決定性は
メモリーモデル の意味的要請であり、弱い一貫性を持つハードウェアの観測可能な挙動を記述するためのものです。 - readEvent を
ReadSharedMemory { [[Order]]:unordered , [[NoTear]]:true , [[Block]]: fromBlock, [[ByteIndex]]: fromIndex, [[ElementSize]]: 1 } とする。 - readEvent を eventsRecord.[[EventList]] に追加する。
Chosen Value Record { [[Event]]: readEvent, [[ChosenValue]]: bytes } を execution.[[ChosenValues]] に追加する。- もし toBlock が
Shared Data Block なら、WriteSharedMemory { [[Order]]:unordered , [[NoTear]]:true , [[Block]]: toBlock, [[ByteIndex]]: toIndex, [[ElementSize]]: 1, [[Payload]]: bytes } を eventsRecord.[[EventList]] に追加する。
- それ以外の場合：
- toBlock[toIndex] に bytes[0] を設定する。
- execution を
- それ以外の場合：
アサート : toBlock はShared Data Block でないこと。- toBlock[toIndex] に fromBlock[fromIndex] を設定する。
- toIndex を toIndex + 1 に設定する。
- fromIndex を fromIndex + 1 に設定する。
- count を count - 1 に設定する。
- もし fromBlock が
unused を返す。
6.2.10 PrivateElement 仕様タイプ
PrivateElement 型は、プライベートクラスフィールド・メソッド・アクセサの仕様で使用される
PrivateElement 型の値は、
| フィールド名 | そのフィールドが存在する [[Kind]] フィールドの値 | 値 | 意味 |
|---|---|---|---|
| [[Key]] | 全て |
|
フィールド、メソッド、またはアクセサの名前。 |
| [[Kind]] | 全て |
|
要素の種類。 |
| [[Value]] |
|
|
フィールドの値。 |
| [[Get]] |
|
|
プライベートアクセサの getter。 |
| [[Set]] |
|
|
プライベートアクセサの setter。 |
6.2.11 ClassFieldDefinition レコード仕様タイプ
ClassFieldDefinition 型は、クラスフィールドの仕様で使用される
ClassFieldDefinition 型の値は
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Name]] |
|
フィールドの名前。 |
| [[Initializer]] |
ECMAScript |
フィールドの初期化子（あれば）。 |
6.2.12 プライベート名
Private Name
仕様タイプは、プライベートクラス要素（フィールド、メソッド、アクセサ）のキーを表すグローバルに一意な値（たとえ他の Private Name
と区別がつかなくても、必ず異なる値）を記述するために用いられます。各 Private Name には、
6.2.13 ClassStaticBlockDefinition レコード仕様タイプ
ClassStaticBlockDefinition
Record は、クラスの static 初期化ブロックの実行可能なコードをカプセル化するために用いられる
ClassStaticBlockDefinition Record は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[BodyFunction]] |
ECMAScript |
クラスの static 初期化時に呼び出される |
7 抽象操作
これらの操作は ECMAScript 言語の一部ではなく、ECMAScript 言語のセマンティクス仕様を補助するためだけにここで定義されています。他にも、より専門的な
7.1 型変換
ECMAScript 言語は必要に応じて暗黙的に自動型変換を行います。特定の構文のセマンティクスを明確にするために、一連の変換
7.1.1 ToPrimitive ( input [ , preferredType ] )
抽象操作 ToPrimitive は、引数 input（
- もし input が
オブジェクト なら、- exoticToPrim を ?
GetMethod (input,%Symbol.toPrimitive% ) とする。 - もし exoticToPrim が
undefined でなければ、- もし preferredType が与えられていなければ、
- hint を
"default" とする。
- hint を
- そうでなく、preferredType が
string なら、- hint を
"string" とする。
- hint を
- それ以外の場合、
アサート : preferredType はnumber である。- hint を
"number" とする。
- result を ?
Call (exoticToPrim, input, « hint » ) とする。 - もし result が
オブジェクトでなければ result を返す。 TypeError 例外をスローする。
- もし preferredType が与えられていなければ、
- もし preferredType が与えられていなければ、preferredType を
number とする。 - ?
OrdinaryToPrimitive (input, preferredType) を返す。
- exoticToPrim を ?
- input を返す。
ToPrimitive がヒントなしで呼ばれた場合、一般的にはヒントが
7.1.1.1 OrdinaryToPrimitive ( O, hint )
抽象操作 OrdinaryToPrimitive は、引数 O（オブジェクト）と
hint（
- もし hint が
string なら、- methodNames を «
"toString" ,"valueOf" » とする。
- methodNames を «
- それ以外の場合、
- methodNames を «
"valueOf" ,"toString" » とする。
- methodNames を «
- methodNames の各要素 name について、
- method を ?
Get (O, name) とする。 - もし
IsCallable (method) がtrue なら、- result を ?
Call (method, O) とする。 - もし result が
オブジェクトでなければ result を返す。
- result を ?
- method を ?
TypeError 例外をスローする。
7.1.2 ToBoolean ( argument )
抽象操作 ToBoolean は、引数 argument（
7.1.3 ToNumeric ( value )
抽象操作 ToNumeric は、引数 value（
- primValue を ?
ToPrimitive (value,number ) とする。 - もし primValue が
BigInt なら、primValue を返す。 - ?
ToNumber (primValue) を返す。
7.1.4 ToNumber ( argument )
抽象操作 ToNumber は、引数 argument（
- もし argument が
Number なら、argument を返す。 - もし argument が Symbol または BigInt なら、
TypeError 例外をスローする。 - もし argument が
undefined なら、NaN を返す。 - もし argument が
null またはfalse なら、+0 𝔽 を返す。 - もし argument が
true なら、1 𝔽 を返す。 - もし argument が
文字列 なら、StringToNumber (argument) を返す。 アサート : argument はオブジェクト である。- primValue を ?
ToPrimitive (argument,number ) とする。 アサート : primValue はオブジェクトでない こと。- ?
ToNumber (primValue) を返す。
7.1.4.1 文字列型に適用される ToNumber
抽象操作
構文
上記で明示的に定義されていない全ての文法記号は、数値リテラルの字句文法（
-
StringNumericLiteral には、先頭および/または末尾に空白や行終端記号を含めることができます。 -
10進数である
StringNumericLiteral には、任意個数の先頭0桁が含まれてよいです。 -
10進数である
StringNumericLiteral には、符号を示すために+や-を含めることができます。 -
空もしくは空白のみの
StringNumericLiteral は+0 𝔽 に変換されます。 -
Infinityおよび-InfinityはStringNumericLiteral では認識されますが、NumericLiteral では認識されません。 -
StringNumericLiteral にはBigIntLiteralSuffix を含めることはできません。 -
StringNumericLiteral にはNumericLiteralSeparator を含めることはできません。
7.1.4.1.1 StringToNumber ( str )
抽象操作 StringToNumber は、引数 str（文字列）を受け取り、数値を返します。呼び出されたとき、次の手順を実行します：
- literal を
ParseText (str,StringNumericLiteral ) とする。 - もし literal が
List のエラーであれば、NaN を返す。 - literal の
StringNumericValue を返す。
7.1.4.1.2 実行時セマンティクス: StringNumericValue
以下の生成規則に対し分割的に定義されます：
+0 𝔽 を返す。
NonDecimalIntegerLiteral の MV を𝔽 で返す。
- a を
StrUnsignedDecimalLiteral のStringNumericValue とする。 - もし a が
+0 𝔽 なら-0 𝔽 を返す。 - -a を返す。
+∞ 𝔽 を返す。
- 最初の
DecimalDigits の MV を a とする。 - 2番目の
DecimalDigits が存在する場合、- 2番目の
DecimalDigits の MV を b とする。 - 2番目の
DecimalDigits の符号位置数を n とする。
- 2番目の
- それ以外の場合、
- b を 0 とする。
- n を 0 とする。
ExponentPart が存在する場合、e をExponentPart の MV とし、それ以外の場合 e を 0 とする。RoundMVResult ((a + (b × 10-n)) × 10e) を返す。
DecimalDigits の MV を b とする。ExponentPart が存在する場合、e をExponentPart の MV とし、それ以外の場合 e を 0 とする。DecimalDigits の符号位置数を n とする。RoundMVResult (b × 10e - n) を返す。
DecimalDigits の MV を a とする。ExponentPart が存在する場合、e をExponentPart の MV とし、それ以外の場合 e を 0 とする。RoundMVResult (a × 10e) を返す。
7.1.4.1.3 RoundMVResult ( n )
抽象操作 RoundMVResult は、引数 n（
7.1.5 ToIntegerOrInfinity ( argument )
抽象操作 ToIntegerOrInfinity は、引数 argument（
7.1.6 ToInt32 ( argument )
抽象操作 ToInt32 は、引数 argument（
上記 ToInt32 の定義により：
- ToInt32 抽象操作は冪等性を持ちます：その結果に再度適用しても値は変わりません。
-
ToInt32(
ToUint32 (x)) は、任意の x に対し ToInt32(x) と同じ値を返します。（この性質を保つために、+∞ 𝔽 と-∞ 𝔽 は+0 𝔽 に変換されます。） -
ToInt32 は
-0 𝔽 を+0 𝔽 にマッピングします。
7.1.7 ToUint32 ( argument )
抽象操作 ToUint32 は、引数 argument（
7.1.8 ToInt16 ( argument )
抽象操作 ToInt16 は、引数 argument（
7.1.9 ToUint16 ( argument )
抽象操作 ToUint16 は、引数 argument（
7.1.10 ToInt8 ( argument )
抽象操作 ToInt8 は、引数 argument（
7.1.11 ToUint8 ( argument )
抽象操作 ToUint8 は、引数 argument（
7.1.12 ToUint8Clamp ( argument )
抽象操作 ToUint8Clamp は、引数 argument（
他のほとんどの ECMAScript Math.round
7.1.13 ToBigInt ( argument )
抽象操作 ToBigInt は、引数 argument（
- prim を ?
ToPrimitive (argument,number ) とする。 - prim に対応する値を
表12 から返す。
| 引数の型 | 結果 |
|---|---|
| Undefined |
|
| Null |
|
| Boolean |
prim が 1n、prim
が 0n を返す。
|
| BigInt | prim を返す。 |
| Number |
|
| String |
|
| Symbol |
|
7.1.14 StringToBigInt ( str )
抽象操作 StringToBigInt は、引数 str（文字列）を受け取り、BigInt または
7.1.14.1 StringIntegerLiteral 文法
構文
7.1.14.2 実行時セマンティクス: MV
-
StringIntegerLiteral ::: StrWhiteSpace opt -
StringIntegerLiteral ::: StrWhiteSpace opt StrIntegerLiteral StrWhiteSpace opt StrIntegerLiteral の MV です。
7.1.15 ToBigInt64 ( argument )
抽象操作 ToBigInt64 は、引数 argument（
7.1.16 ToBigUint64 ( argument )
抽象操作 ToBigUint64 は、引数 argument（
7.1.17 ToString ( argument )
抽象操作 ToString は、引数 argument（
- もし argument が
文字列 なら、argument を返す。 - もし argument が
シンボル なら、TypeError 例外を投げる。 - もし argument が
undefined なら、"undefined" を返す。 - もし argument が
null なら、"null" を返す。 - もし argument が
true なら、"true" を返す。 - もし argument が
false なら、"false" を返す。 - もし argument が
数値 なら、Number::toString (argument, 10) を返す。 - もし argument が
BigInt なら、BigInt::toString (argument, 10) を返す。 アサート : argument はオブジェクト である。- primValue を ?
ToPrimitive (argument,string ) とする。 アサート : primValue はオブジェクトでない こと。- ?
ToString (primValue) を返す。
7.1.18 ToObject ( argument )
抽象操作 ToObject は、引数 argument（
| 引数の型 | 結果 |
|---|---|
| Undefined |
|
| Null |
|
| Boolean |
[[BooleanData]] 内部スロットが argument
に設定された新しい Boolean オブジェクトを返す。Boolean オブジェクトの説明は |
| Number |
[[NumberData]] 内部スロットが argument
に設定された新しい Number オブジェクトを返す。Number オブジェクトの説明は |
| String |
[[StringData]] 内部スロットが argument
に設定された新しい String オブジェクトを返す。String オブジェクトの説明は |
| Symbol |
[[SymbolData]] 内部スロットが argument
に設定された新しい Symbol オブジェクトを返す。Symbol オブジェクトの説明は |
| BigInt |
[[BigIntData]] 内部スロットが argument
に設定された新しい BigInt オブジェクトを返す。BigInt オブジェクトの説明は |
| Object | argument を返す。 |
7.1.19 ToPropertyKey ( argument )
抽象操作 ToPropertyKey は、引数 argument（
- key を ?
ToPrimitive (argument,string ) とする。 - もし key が
シンボル なら、- key を返す。
- !
ToString (key) を返す。
7.1.20 ToLength ( argument )
抽象操作 ToLength は、引数 argument（
- len を ?
ToIntegerOrInfinity (argument) とする。 - もし len ≤ 0 なら、
+0 𝔽 を返す。 𝔽 (min (len, 253 - 1)) を返す。
7.1.21 CanonicalNumericIndexString ( argument )
抽象操作 CanonicalNumericIndexString は、引数 argument（文字列）を受け取り、数値または
canonical numeric string
とは、CanonicalNumericIndexString 抽象操作が
7.1.22 ToIndex ( value )
抽象操作 ToIndex は、引数 value（
- integer を ?
ToIntegerOrInfinity (value) とする。 - もし integer が
区間 0 から 253 - 1 に含まれていなければ、RangeError 例外を投げる。 - integer を返す。
7.2 テストおよび比較操作
7.2.1 RequireObjectCoercible ( argument )
抽象操作 RequireObjectCoercible は、引数 argument（
| 引数の型 | 結果 |
|---|---|
| Undefined |
|
| Null |
|
| Boolean | argument を返す。 |
| Number | argument を返す。 |
| String | argument を返す。 |
| Symbol | argument を返す。 |
| BigInt | argument を返す。 |
| Object | argument を返す。 |
7.2.2 IsArray ( argument )
抽象操作 IsArray は、引数 argument（
- もし argument が
オブジェクトでない 場合、false を返す。 - もし argument が
配列エキゾチックオブジェクト ならtrue を返す。 - もし argument が
Proxy エキゾチックオブジェクト なら、- ?
ValidateNonRevokedProxy (argument) を行う。 - proxyTarget を argument.[[ProxyTarget]] とする。
- ?
IsArray (proxyTarget) を返す。
- ?
false を返す。
7.2.3 IsCallable ( argument )
抽象操作 IsCallable は、引数 argument（
- もし argument が
オブジェクトでない 場合、false を返す。 - もし argument が [[Call]] 内部メソッドを持てば
true を返す。 false を返す。
7.2.4 IsConstructor ( argument )
抽象操作 IsConstructor は、引数 argument（
- もし argument が
オブジェクトでない 場合、false を返す。 - もし argument が [[Construct]] 内部メソッドを持てば
true を返す。 false を返す。
7.2.5 IsExtensible ( O )
抽象操作 IsExtensible は、引数 O（オブジェクト）を受け取り、
- ? O.[[IsExtensible]]() を返す。
7.2.6 IsRegExp ( argument )
抽象操作 IsRegExp は、引数 argument（
- もし argument が
オブジェクトでない 場合、false を返す。 - matcher を ?
Get (argument,%Symbol.match% ) とする。 - もし matcher が
undefined でなければ、ToBoolean (matcher) を返す。 - もし argument が [[RegExpMatcher]]
内部スロットを持てば、
true を返す。 false を返す。
7.2.7 静的セマンティクス: IsStringWellFormedUnicode ( string )
抽象操作 IsStringWellFormedUnicode は、引数 string（文字列）を受け取り、Boolean を返します。string を
- len を string の長さとする。
- k を 0 とする。
- 繰り返し、k < len の間:
- cp を
CodePointAt (string, k) とする。 - もし cp.[[IsUnpairedSurrogate]] が
true なら、false を返す。 - k を k + cp.[[CodeUnitCount]] に設定する。
- cp を
true を返す。
7.2.8 SameType ( x, y )
抽象操作 SameType は、引数 x（
- もし x が
undefined かつ y もundefined ならtrue を返す。 - もし x が
null かつ y もnull ならtrue を返す。 - もし x が
Boolean かつ y もBoolean ならtrue を返す。 - もし x が
Number かつ y もNumber ならtrue を返す。 - もし x が
BigInt かつ y もBigInt ならtrue を返す。 - もし x が
シンボル かつ y もシンボル ならtrue を返す。 - もし x が
文字列 かつ y も文字列 ならtrue を返す。 - もし x が
オブジェクト かつ y もオブジェクト ならtrue を返す。 false を返す。
7.2.9 SameValue ( x, y )
抽象操作 SameValue は、引数 x（
- もし
SameType (x, y) がfalse なら、false を返す。 - もし x が
Number なら、Number::sameValue (x, y) を返す。
SameValueNonNumber (x, y) を返す。
このアルゴリズムは
7.2.10 SameValueZero ( x, y )
抽象操作 SameValueZero は、引数 x（
- もし
SameType (x, y) がfalse なら、false を返す。 - もし x が
Number なら、Number::sameValueZero (x, y) を返す。
SameValueNonNumber (x, y) を返す。
SameValueZero は
7.2.11 SameValueNonNumber ( x, y )
抽象操作 SameValueNonNumber は、引数 x（
アサート :SameType (x, y) はtrue である。- もし x が
undefined またはnull なら、true を返す。 - もし x が
BigInt なら、BigInt::equal (x, y) を返す。
- もし x が
文字列 なら、- もし x と y の長さが等しく、かつ同じ位置のコード単位が全て一致するなら
true を返し、そうでなければfalse を返す。
- もし x と y の長さが等しく、かつ同じ位置のコード単位が全て一致するなら
- もし x が
Boolean なら、- もし x と y がともに
true かともにfalse ならtrue を返し、そうでなければfalse を返す。
- もし x と y がともに
- 注：その他の
ECMAScript 言語値 は同一性(identity)で比較されます。 - もし x が y であれば
true 、そうでなければfalse を返す。
7.2.12 IsLessThan ( x, y, LeftFirst )
抽象操作 IsLessThan は、引数 x（
- もし LeftFirst が
true なら、- px を ?
ToPrimitive (x,number ) とする。 - py を ?
ToPrimitive (y,number ) とする。
- px を ?
- それ以外の場合、
- 注：評価順を逆にすることで左から右の評価を保証する必要がある。
- py を ?
ToPrimitive (y,number ) とする。 - px を ?
ToPrimitive (x,number ) とする。
- もし px が
文字列 かつ py も文字列 なら、 - それ以外の場合、
- もし px が
BigInt かつ py が文字列 なら、- ny を
StringToBigInt (py) とする。 - もし ny が
undefined ならundefined を返す。 BigInt::lessThan (px, ny) を返す。
- ny を
- もし px が
文字列 かつ py がBigInt なら、- nx を
StringToBigInt (px) とする。 - もし nx が
undefined ならundefined を返す。 BigInt::lessThan (nx, py) を返す。
- nx を
- 注：px と py はプリミティブ値なので評価順は重要でない。
- nx を ?
ToNumeric (px) とする。 - ny を ?
ToNumeric (py) とする。 - もし
SameType (nx, ny) がtrue なら、- もし nx が
Number なら、Number::lessThan (nx, ny) を返す。
- それ以外の場合、
アサート : nx はBigInt である。BigInt::lessThan (nx, ny) を返す。
- もし nx が
アサート : nx はBigInt で、ny はNumber 、または nx はNumber で ny はBigInt 。- もし nx または ny が
NaN ならundefined を返す。 - もし nx が
-∞ 𝔽 または ny が+∞ 𝔽 ならtrue を返す。 - もし nx が
+∞ 𝔽 または ny が-∞ 𝔽 ならfalse を返す。 - もし
ℝ (nx) <ℝ (ny) ならtrue を返し、そうでなければfalse を返す。
- もし px が
文字列の比較は UTF-16 コード単位列に対する単純な辞書順比較を用います。Unicode
仕様で定義されるより複雑で意味論的な文字・文字列の等価性や照合順序は考慮されません。そのため、Unicode
標準で正規等価な値であっても正規化形式が異なる場合は等価判定されないことがあります。また、コード単位による辞書順は、
7.2.13 IsLooselyEqual ( x, y )
抽象操作 IsLooselyEqual は、引数 x（== 演算子の意味を与えます。呼び出されたとき、次の手順を実行します：
- もし
SameType (x, y) がtrue なら、IsStrictlyEqual (x, y) を返す。
- もし x が
null かつ y がundefined ならtrue を返す。 - もし x が
undefined かつ y がnull ならtrue を返す。 - 注：このステップは
B.3.6.2 で置き換えられます。 - もし x が
Number かつ y が文字列 なら、!IsLooselyEqual (x, !ToNumber (y)) を返す。 - もし x が
文字列 かつ y がNumber なら、!IsLooselyEqual (!ToNumber (x), y) を返す。 - もし x が
BigInt かつ y が文字列 なら、- n を
StringToBigInt (y) とする。 - もし n が
undefined ならfalse を返す。 - !
IsLooselyEqual (x, n) を返す。
- n を
- もし x が
文字列 かつ y がBigInt なら、!IsLooselyEqual (y, x) を返す。 - もし x が
Boolean なら、!IsLooselyEqual (!ToNumber (x), y) を返す。 - もし y が
Boolean なら、!IsLooselyEqual (x, !ToNumber (y)) を返す。 - もし x が 文字列、数値、BigInt、またはシンボルのいずれかで y が
オブジェクト なら、!IsLooselyEqual (x, ?ToPrimitive (y)) を返す。 - もし x が
オブジェクト かつ y が 文字列、数値、BigInt、またはシンボルのいずれかなら、!IsLooselyEqual (?ToPrimitive (x), y) を返す。 - もし x が
BigInt かつ y がNumber 、または x がNumber かつ y がBigInt なら、 false を返す。
7.2.14 IsStrictlyEqual ( x, y )
抽象操作 IsStrictlyEqual は、引数 x（=== 演算子の意味を与えます。呼び出されたとき、次の手順を実行します：
- もし
SameType (x, y) がfalse なら、false を返す。 - もし x が
Number なら、Number::equal (x, y) を返す。
SameValueNonNumber (x, y) を返す。
このアルゴリズムは
7.3 オブジェクトに対する操作
7.3.1 MakeBasicObject ( internalSlotsList )
抽象操作 MakeBasicObject は、引数 internalSlotsList（
- internalSlotsList を
リスト連結 で internalSlotsList と « [[PrivateElements]] » の連結に設定する。 - internalSlotsList の各名前に対応する内部スロットを持つ新しいオブジェクト obj を生成する。
- 注：
オブジェクトの内部メソッドと内部スロット で説明されているように、これらの内部スロットの初期値は特に指定がない限りundefined である。 - obj.[[PrivateElements]] を新しい空の
リスト に設定する。 - obj の本質的な内部メソッドを、
通常オブジェクト の10.1 で規定されるデフォルトの定義に設定する。 アサート : 呼び出し元が obj の [[GetPrototypeOf]] および [[SetPrototypeOf]] の両方の本質的な内部メソッドを上書きしないなら、internalSlotsList は [[Prototype]] を含む。アサート : 呼び出し元が obj の [[SetPrototypeOf]], [[IsExtensible]], [[PreventExtensions]] の全ての本質的な内部メソッドを上書きしないなら、internalSlotsList は [[Extensible]] を含む。- もし internalSlotsList が [[Extensible]]
を含むなら、obj.[[Extensible]] を
true に設定する。 - obj を返す。
本仕様内では、
7.3.2 Get ( O, P )
抽象操作 Get は、引数 O（オブジェクト）と P（
- ? O.[[Get]](P, O) を返す。
7.3.3 GetV ( V, P )
抽象操作 GetV は、引数 V（
- O を ?
ToObject (V) とする。 - ? O.[[Get]](P, V) を返す。
7.3.4 Set ( O, P, V, Throw )
抽象操作 Set は、引数 O（オブジェクト）、P（
- success を ? O.[[Set]](P, V, O) とする。
- もし success が
false かつ Throw がtrue なら、TypeError 例外を投げる。 unused を返す。
7.3.5 CreateDataProperty ( O, P, V )
抽象操作 CreateDataProperty は、引数 O（オブジェクト）、P（
- newDesc を PropertyDescriptor { [[Value]]:
V, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:true } とする。 - ? O.[[DefineOwnProperty]](P, newDesc) を返す。
この抽象操作は、ECMAScript
言語の代入演算子によって作成されるプロパティと同じデフォルト属性でプロパティを生成します。通常、このプロパティは既存しません。もし既に存在し、それが設定可能でない場合や
O が拡張不可能な場合、[[DefineOwnProperty]] は
7.3.6 CreateDataPropertyOrThrow ( O, P, V )
抽象操作 CreateDataPropertyOrThrow は、引数 O（オブジェクト）、P（
- success を ?
CreateDataProperty (O, P, V) とする。 - もし success が
false なら、TypeError 例外を投げる。 unused を返す。
この抽象操作は、ECMAScript
言語の代入演算子によって作成されるプロパティと同じデフォルト属性でプロパティを生成します。通常、このプロパティは既存しません。もし既に存在し、それが設定可能でない場合や
O が拡張不可能な場合、[[DefineOwnProperty]] は
7.3.7 CreateNonEnumerableDataPropertyOrThrow ( O, P, V )
抽象操作 CreateNonEnumerableDataPropertyOrThrow は、引数 O（オブジェクト）、P（
アサート : O は通常の拡張可能なオブジェクトで、非設定可能なプロパティを持たない。- newDesc を PropertyDescriptor { [[Value]]:
V, [[Writable]]:
true , [[Enumerable]]:false , [[Configurable]]:true } とする。 - !
DefinePropertyOrThrow (O, P, newDesc) を実行する。 unused を返す。
この抽象操作は、ECMAScript
言語の代入演算子で生成されるプロパティと同じデフォルト属性でプロパティを作成しますが、列挙不可となる点が異なります。通常、このプロパティは既存しません。もし既に存在する場合、
7.3.8 DefinePropertyOrThrow ( O, P, desc )
抽象操作 DefinePropertyOrThrow は、引数 O（オブジェクト）、P（
- success を ? O.[[DefineOwnProperty]](P, desc) とする。
- もし success が
false なら、TypeError 例外を投げる。 unused を返す。
7.3.9 DeletePropertyOrThrow ( O, P )
抽象操作 DeletePropertyOrThrow は、引数 O（オブジェクト）と P（
- success を ? O.[[Delete]](P) とする。
- もし success が
false なら、TypeError 例外を投げる。 unused を返す。
7.3.10 GetMethod ( V, P )
抽象操作 GetMethod は、引数 V（
- func を ?
GetV (V, P) とする。 - もし func が
undefined またはnull なら、undefined を返す。 - もし
IsCallable (func) がfalse なら、TypeError 例外を投げる。 - func を返す。
7.3.11 HasProperty ( O, P )
抽象操作 HasProperty は、引数 O（オブジェクト）と P（
- ? O.[[HasProperty]](P) を返す。
7.3.12 HasOwnProperty ( O, P )
抽象操作 HasOwnProperty は、引数 O（オブジェクト）と P（
- desc を ? O.[[GetOwnProperty]](P) とする。
- もし desc が
undefined ならfalse を返す。 true を返す。
7.3.13 Call ( F, V [ , argumentsList ] )
抽象操作 Call は、引数 F（
- もし argumentsList が省略された場合、argumentsList を新しい空の
リスト に設定する。 - もし
IsCallable (F) がfalse なら、TypeError 例外を投げる。 - ? F.[[Call]](V, argumentsList) を返す。
7.3.14 Construct ( F [ , argumentsList [ , newTarget ] ] )
抽象操作 Construct は、引数 F（
- もし newTarget が省略された場合、newTarget を F に設定する。
- もし argumentsList が省略された場合、argumentsList を新しい空の
リスト に設定する。 - ? F.[[Construct]](argumentsList, newTarget) を返す。
newTarget が省略された場合、この操作は new F(...argumentsList) と同等です。
7.3.15 SetIntegrityLevel ( O, level )
抽象操作 SetIntegrityLevel は、引数 O（オブジェクト）、level（
- status を ? O.[[PreventExtensions]]() とする。
- もし status が
false なら、false を返す。 - keys を ? O.[[OwnPropertyKeys]]() とする。
- もし level が
sealed なら、- keys の各要素 k について、
- ?
DefinePropertyOrThrow (O, k, PropertyDescriptor { [[Configurable]]:false }) を実行する。
- ?
- keys の各要素 k について、
- それ以外の場合、
アサート : level はfrozen である。- keys の各要素 k について、
- currentDesc を ? O.[[GetOwnProperty]](k) とする。
- もし currentDesc が
undefined でなければ、- もし
IsAccessorDescriptor (currentDesc) がtrue なら、- desc を PropertyDescriptor { [[Configurable]]:
false } とする。
- desc を PropertyDescriptor { [[Configurable]]:
- それ以外の場合、
- desc を PropertyDescriptor { [[Configurable]]:
false , [[Writable]]:false } とする。
- desc を PropertyDescriptor { [[Configurable]]:
- ?
DefinePropertyOrThrow (O, k, desc) を実行する。
- もし
true を返す。
7.3.16 TestIntegrityLevel ( O, level )
抽象操作 TestIntegrityLevel は、引数 O（オブジェクト）、level（
- extensible を ?
IsExtensible (O) とする。 - もし extensible が
true なら、false を返す。 - 注：オブジェクトが拡張可能である場合、そのプロパティは検査されません。
- keys を ? O.[[OwnPropertyKeys]]() とする。
- keys の各要素 k について、
- currentDesc を ? O.[[GetOwnProperty]](k) とする。
- もし currentDesc が
undefined でなければ、- もし currentDesc.[[Configurable]] が
true なら、false を返す。 - もし level が
frozen かつIsDataDescriptor (currentDesc) がtrue なら、- もし currentDesc.[[Writable]]
が
true なら、false を返す。
- もし currentDesc.[[Writable]]
が
- もし currentDesc.[[Configurable]] が
true を返す。
7.3.17 CreateArrayFromList ( elements )
抽象操作 CreateArrayFromList は、引数 elements（
- array を !
ArrayCreate (0) とする。 - n を 0 とする。
- elements の各要素 e について、
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), e) を実行する。 - n を n + 1 に設定する。
- !
- array を返す。
7.3.18 LengthOfArrayLike ( obj )
抽象操作 LengthOfArrayLike は、引数 obj（オブジェクト）を受け取り、
配列様オブジェクト とは、この操作が
7.3.19 CreateListFromArrayLike ( obj [ , validElementTypes ] )
抽象操作 CreateListFromArrayLike は、引数 obj（
- もし validElementTypes が指定されていなければ、validElementTypes を
all に設定する。 - もし obj が
オブジェクトでない なら、TypeError 例外を投げる。 - len を ?
LengthOfArrayLike (obj) とする。 - list を新しい空の
リスト とする。 - index を 0 とする。
- index < len の間、繰り返し：
- list を返す。
7.3.20 Invoke ( V, P [ , argumentsList ] )
抽象操作 Invoke は、引数 V（
7.3.21 OrdinaryHasInstance ( C, O )
抽象操作 OrdinaryHasInstance は、引数 C（
- もし
IsCallable (C) がfalse なら、false を返す。 - もし C が [[BoundTargetFunction]] 内部スロットを持つなら、
- BC を C.[[BoundTargetFunction]] とする。
- ?
InstanceofOperator (O, BC) を返す。
- もし O が
オブジェクトでない なら、false を返す。 - P を ?
Get (C,"prototype" ) とする。 - もし P が
オブジェクトでない なら、TypeError 例外を投げる。 - 繰り返し：
- O を ? O.[[GetPrototypeOf]]() に設定する。
- もし O が
null なら、false を返す。 - もし
SameValue (P, O) がtrue なら、true を返す。
7.3.22 SpeciesConstructor ( O, defaultConstructor )
抽象操作 SpeciesConstructor は、引数 O（オブジェクト）、defaultConstructor（
- C を ?
Get (O,"constructor" ) とする。 - もし C が
undefined なら、defaultConstructor を返す。 - もし C が
オブジェクトでない なら、TypeError 例外を投げる。 - S を ?
Get (C,%Symbol.species% ) とする。 - もし S が
undefined またはnull なら、defaultConstructor を返す。 - もし
IsConstructor (S) がtrue なら、S を返す。 TypeError 例外を投げる。
7.3.23 EnumerableOwnProperties ( O, kind )
抽象操作 EnumerableOwnProperties は、引数
O（オブジェクト）、kind（
- ownKeys を ? O.[[OwnPropertyKeys]]() とする。
- results を新しい空の
リスト とする。 - ownKeys の各要素 key について：
- もし key が
文字列 なら、- desc を ? O.[[GetOwnProperty]](key) とする。
- もし desc が
undefined でなく、かつ desc.[[Enumerable]] がtrue なら、- もし kind が
key なら、- key を results に追加する。
- それ以外の場合、
- value を ?
Get (O, key) とする。 - もし kind が
value なら、- value を results に追加する。
- それ以外の場合、
アサート : kind はkey+value である。- entry を
CreateArrayFromList («key, value » ) とする。 - entry を results に追加する。
- value を ?
- もし kind が
- もし key が
- results を返す。
7.3.24 GetFunctionRealm ( obj )
抽象操作 GetFunctionRealm は、引数 obj（
- もし obj が [[Realm]] 内部スロットを持つなら、
- obj.[[Realm]] を返す。
- もし obj が
束縛関数エキゾチックオブジェクト なら、- boundTargetFunction を obj.[[BoundTargetFunction]] とする。
- ?
GetFunctionRealm (boundTargetFunction) を返す。
- もし obj が
Proxy エキゾチックオブジェクト なら、- ?
ValidateNonRevokedProxy (obj) を実行する。 - proxyTarget を obj.[[ProxyTarget]] とする。
アサート : proxyTarget は関数オブジェクト である。- ?
GetFunctionRealm (proxyTarget) を返す。
- ?
現在の Realm Record を返す。
ステップ
7.3.25 CopyDataProperties ( target, source, excludedItems )
抽象操作 CopyDataProperties は、引数 target（オブジェクト）、source（
- もし source が
undefined またはnull なら、unused を返す。 - from を !
ToObject (source) とする。 - keys を ? from.[[OwnPropertyKeys]]() とする。
- keys の各要素 nextKey について、
- excluded を
false に設定する。 - excludedItems の各要素 e について、
- もし
SameValue (e, nextKey) がtrue なら、- excluded を
true に設定する。
- excluded を
- もし
- もし excluded が
false なら、- desc を ? from.[[GetOwnProperty]](nextKey) とする。
- もし desc が
undefined でなく、かつ desc.[[Enumerable]] がtrue なら、- propValue を ?
Get (from, nextKey) とする。 - !
CreateDataPropertyOrThrow (target, nextKey, propValue) を実行する。
- propValue を ?
- excluded を
unused を返す。
ここで渡される target は常に新しく作成されたオブジェクトであり、エラーが投げられた場合に直接アクセスすることはできません。
7.3.26 PrivateElementFind ( O, P )
抽象操作 PrivateElementFind は、引数 O（オブジェクト）、P（
- もし O.[[PrivateElements]] が
PrivateElement pe を含み、かつ pe.[[Key]] が P であるなら、- pe を返す。
empty を返す。
7.3.27 PrivateFieldAdd ( O, P, value )
抽象操作 PrivateFieldAdd は、引数 O（オブジェクト）、P（
- もし
ホスト が Webブラウザなら、- ?
HostEnsureCanAddPrivateElement (O) を実行する。
- ?
- entry を
PrivateElementFind (O, P) とする。 - もし entry が
empty でないなら、TypeError 例外を投げる。 PrivateElement { [[Key]]: P, [[Kind]]:field , [[Value]]: value } を O.[[PrivateElements]] に追加する。unused を返す。
7.3.28 PrivateMethodOrAccessorAdd ( O, method )
抽象操作 PrivateMethodOrAccessorAdd は、引数 O（オブジェクト）、method（
アサート : method.[[Kind]] はmethod またはaccessor である。- もし
ホスト が Webブラウザなら、- ?
HostEnsureCanAddPrivateElement (O) を実行する。
- ?
- entry を
PrivateElementFind (O, method.[[Key]]) とする。 - もし entry が
empty でないなら、TypeError 例外を投げる。 - method を O.[[PrivateElements]] に追加する。
unused を返す。
プライベートメソッドおよびアクセサの値はインスタンス間で共有されます。この操作はメソッドやアクセサのコピーを新たに作成しません。
7.3.29 HostEnsureCanAddPrivateElement ( O )
HostEnsureCanAddPrivateElement の実装は以下の要件を満たさなければなりません：
- もし O が
ホスト定義 エキゾチックオブジェクト でなければ、この抽象操作はNormalCompletion (unused ) を返し、他の手順を実行してはならない。 - 同じ引数でこの抽象操作を2回呼び出した場合、同じ種類の
Completion Record を返さなければならない。
HostEnsureCanAddPrivateElement のデフォルト実装は
この抽象操作は ECMAScript の
7.3.30 PrivateGet ( O, P )
抽象操作 PrivateGet は、引数 O（オブジェクト）、P（
- entry を
PrivateElementFind (O, P) とする。 - もし entry が
empty なら、TypeError 例外を投げる。 - もし entry.[[Kind]] が
field またはmethod なら、- entry.[[Value]] を返す。
アサート : entry.[[Kind]] はaccessor である。- もし entry.[[Get]] が
undefined なら、TypeError 例外を投げる。 - getter を entry.[[Get]] とする。
- ?
Call (getter, O) を返す。
7.3.31 PrivateSet ( O, P, value )
抽象操作 PrivateSet は、引数 O（オブジェクト）、P（
- entry を
PrivateElementFind (O, P) とする。 - もし entry が
empty なら、TypeError 例外を投げる。 - もし entry.[[Kind]] が
field なら、- entry.[[Value]] を value に設定する。
- それ以外で entry.[[Kind]] が
method なら、TypeError 例外を投げる。
- それ以外の場合、
unused を返す。
7.3.32 DefineField ( receiver, fieldRecord )
抽象操作 DefineField は、引数 receiver（オブジェクト）、fieldRecord（
- fieldName を fieldRecord.[[Name]] とする。
- initializer を fieldRecord.[[Initializer]] とする。
- もし initializer が
empty でないなら、- initValue を ?
Call (initializer, receiver) とする。
- initValue を ?
- それ以外の場合、
- initValue を
undefined とする。
- initValue を
- もし fieldName が
Private Name なら、- ?
PrivateFieldAdd (receiver, fieldName, initValue) を実行する。
- ?
- それ以外の場合、
アサート : fieldName はプロパティキー である。- ?
CreateDataPropertyOrThrow (receiver, fieldName, initValue) を実行する。
unused を返す。
7.3.33 InitializeInstanceElements ( O, constructor )
抽象操作 InitializeInstanceElements は、引数 O（オブジェクト）、constructor（ECMAScript
- methods を constructor.[[PrivateMethods]] とする。
- methods の各
PrivateElement method について、- ?
PrivateMethodOrAccessorAdd (O, method) を実行する。
- ?
- fields を constructor.[[Fields]] とする。
- fields の各要素 fieldRecord について、
- ?
DefineField (O, fieldRecord) を実行する。
- ?
unused を返す。
7.3.34 AddValueToKeyedGroup ( groups, key, value )
抽象操作 AddValueToKeyedGroup は、引数 groups（
7.3.35 GroupBy ( items, callback, keyCoercion )
抽象操作 GroupBy は、引数 items（
- ?
RequireObjectCoercible (items) を実行する。 - もし
IsCallable (callback) がfalse なら、TypeError 例外を投げる。 - groups を新しい空の
リスト とする。 - iteratorRecord を ?
GetIterator (items,sync ) とする。 - k を 0 とする。
- 繰り返し：
- もし k ≥ 253 - 1 なら、
- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iteratorRecord, error) を返す。
- error を
- next を ?
IteratorStepValue (iteratorRecord) とする。 - もし next が
done なら、- groups を返す。
- value を next とする。
- key を
Completion (Call (callback,undefined , « value,𝔽 (k) » )) とする。 IfAbruptCloseIterator (key, iteratorRecord) を実行する。- もし keyCoercion が
property なら、- key を
Completion (ToPropertyKey (key)) に設定する。 IfAbruptCloseIterator (key, iteratorRecord) を実行する。
- key を
- それ以外の場合、
アサート : keyCoercion はcollection である。- key を
CanonicalizeKeyedCollectionKey (key) に設定する。
AddValueToKeyedGroup (groups, key, value) を実行する。- k を k + 1 に設定する。
- もし k ≥ 253 - 1 なら、
7.3.36 SetterThatIgnoresPrototypeProperties ( thisValue, home, p, v )
抽象操作 SetterThatIgnoresPrototypeProperties は、引数 thisValue（
- もし thisValue が
オブジェクトでない なら、TypeError 例外を投げる。
- もし
SameValue (thisValue, home) がtrue なら、 - desc を ? thisValue.[[GetOwnProperty]](p) とする。
- もし desc が
undefined なら、- ?
CreateDataPropertyOrThrow (thisValue, p, v) を実行する。
- ?
- それ以外の場合、
- ?
Set (thisValue, p, v,true ) を実行する。
- ?
unused を返す。
7.4 イテレータオブジェクトに対する操作
共通のイテレーションインターフェース（
7.4.1 イテレータレコード
イテレータレコード とは、next
メソッドをカプセル化するために使用されます。
イテレータレコードは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Iterator]] | オブジェクト |
|
| [[NextMethod]] |
|
[[Iterator]] オブジェクトの next メソッド。
|
| [[Done]] | Boolean |
|
7.4.2 GetIteratorDirect ( obj )
抽象操作 GetIteratorDirect は、引数 obj（オブジェクト）を受け取り、
7.4.3 GetIteratorFromMethod ( obj, method )
抽象操作 GetIteratorFromMethod は、引数 obj（
- iterator を ?
Call (method, obj) とする。 - もし iterator が
オブジェクトでない なら、TypeError 例外を投げる。 - ?
GetIteratorDirect (iterator) を返す。
7.4.4 GetIterator ( obj, kind )
抽象操作 GetIterator は、引数 obj（
- もし kind が
async なら、- method を ?
GetMethod (obj,%Symbol.asyncIterator% ) とする。 - もし method が
undefined なら、- syncMethod を ?
GetMethod (obj,%Symbol.iterator% ) とする。 - もし syncMethod が
undefined なら、TypeError 例外を投げる。 - syncIteratorRecord を ?
GetIteratorFromMethod (obj, syncMethod) とする。 CreateAsyncFromSyncIterator (syncIteratorRecord) を返す。
- syncMethod を ?
- method を ?
- それ以外の場合、
- method を ?
GetMethod (obj,%Symbol.iterator% ) とする。
- method を ?
- もし method が
undefined なら、TypeError 例外を投げる。 - ?
GetIteratorFromMethod (obj, method) を返す。
7.4.5 GetIteratorFlattenable ( obj, primitiveHandling )
抽象操作 GetIteratorFlattenable は、引数 obj（
- もし obj が
オブジェクトでない なら、 - method を ?
GetMethod (obj,%Symbol.iterator% ) とする。 - もし method が
undefined なら、- iterator を obj とする。
- それ以外の場合、
- iterator を ?
Call (method, obj) とする。
- iterator を ?
- もし iterator が
オブジェクトでない なら、TypeError 例外を投げる。 - ?
GetIteratorDirect (iterator) を返す。
7.4.6 IteratorNext ( iteratorRecord [ , value ] )
抽象操作 IteratorNext は、引数 iteratorRecord（
- もし value が指定されていなければ、
- result を
Completion (Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])) とする。
- result を
- それ以外の場合、
- result を
Completion (Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « value »)) とする。
- result を
- もし result が
throw completion なら、- iteratorRecord.[[Done]] を
true に設定する。 - ? result を返す。
- iteratorRecord.[[Done]] を
- result を ! result に設定する。
- もし result が
オブジェクトでない なら、- iteratorRecord.[[Done]] を
true に設定する。 TypeError 例外を投げる。
- iteratorRecord.[[Done]] を
- result を返す。
7.4.7 IteratorComplete ( iteratorResult )
抽象操作 IteratorComplete は、引数 iteratorResult（オブジェクト）を受け取り、
7.4.8 IteratorValue ( iteratorResult )
抽象操作 IteratorValue は、引数 iteratorResult（オブジェクト）を受け取り、
- ?
Get (iteratorResult,"value" ) を返す。
7.4.9 IteratorStep ( iteratorRecord )
抽象操作 IteratorStep は、引数 iteratorRecord（
- result を ?
IteratorNext (iteratorRecord) とする。 - done を
Completion (IteratorComplete (result)) とする。 - もし done が
throw completion なら、- iteratorRecord.[[Done]] を
true に設定する。 - ? done を返す。
- iteratorRecord.[[Done]] を
- done を ! done に設定する。
- もし done が
true なら、- iteratorRecord.[[Done]] を
true に設定する。 done を返す。
- iteratorRecord.[[Done]] を
- result を返す。
7.4.10 IteratorStepValue ( iteratorRecord )
抽象操作 IteratorStepValue は、引数 iteratorRecord（
- result を ?
IteratorStep (iteratorRecord) とする。 - もし result が
done なら、done を返す。
- value を
Completion (IteratorValue (result)) とする。 - もし value が
throw completion なら、- iteratorRecord.[[Done]] を
true に設定する。
- iteratorRecord.[[Done]] を
- ? value を返す。
7.4.11 IteratorClose ( iteratorRecord, completion )
抽象操作 IteratorClose は、引数 iteratorRecord（
アサート : iteratorRecord.[[Iterator]] がオブジェクト である。- iterator を iteratorRecord.[[Iterator]] とする。
- innerResult を
Completion (GetMethod (iterator,"return" )) とする。 - もし innerResult が
normal completion なら、- return を innerResult.[[Value]] とする。
- もし return が
undefined なら、? completion を返す。 - innerResult を
Completion (Call (return, iterator)) に設定する。
- もし completion が
throw completion なら、? completion を返す。 - もし innerResult が
throw completion なら、? innerResult を返す。 - もし innerResult.[[Value]] が
オブジェクトでない なら、TypeError 例外を投げる。 - ? completion を返す。
7.4.12 IfAbruptCloseIterator ( value, iteratorRecord )
IfAbruptCloseIterator は
IfAbruptCloseIterator (value, iteratorRecord)。
は、次と同じ意味になります：
アサート : value はCompletion Record である。- もし value が
abrupt completion なら、?IteratorClose (iteratorRecord, value) を返す。 - それ以外の場合、value を ! value に設定する。
7.4.13 AsyncIteratorClose ( iteratorRecord, completion )
抽象操作 AsyncIteratorClose は、引数 iteratorRecord（
アサート : iteratorRecord.[[Iterator]] がオブジェクト である。- iterator を iteratorRecord.[[Iterator]] とする。
- innerResult を
Completion (GetMethod (iterator,"return" )) とする。 - もし innerResult が
normal completion なら、- return を innerResult.[[Value]] とする。
- もし return が
undefined なら、? completion を返す。 - innerResult を
Completion (Call (return, iterator)) に設定する。 - もし innerResult が
normal completion なら、innerResult をCompletion (Await (innerResult.[[Value]])) に設定する。
- もし completion が
throw completion なら、? completion を返す。 - もし innerResult が
throw completion なら、? innerResult を返す。 - もし innerResult.[[Value]] が
オブジェクトでない なら、TypeError 例外を投げる。 - ? completion を返す。
7.4.14 CreateIteratorResultObject ( value, done )
抽象操作 CreateIteratorResultObject は、引数 value（
- obj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - !
CreateDataPropertyOrThrow (obj,"value" , value) を実行する。 - !
CreateDataPropertyOrThrow (obj,"done" , done) を実行する。 - obj を返す。
7.4.15 CreateListIteratorRecord ( list )
抽象操作 CreateListIteratorRecord は、引数 list（
- closure を引数なしで list をキャプチャし、呼び出されたとき以下の手順を実行する新しい
Abstract Closure とする：- list の各要素 E について、
- ?
GeneratorYield (CreateIteratorResultObject (E,false )) を実行する。
- ?
NormalCompletion (undefined ) を返す。
- list の各要素 E について、
- iterator を
CreateIteratorFromClosure (closure,empty ,%Iterator.prototype% ) とする。 イテレータレコード { [[Iterator]]: iterator, [[NextMethod]]: %GeneratorPrototype.next%, [[Done]]:false } を返す。
7.4.16 IteratorToList ( iteratorRecord )
抽象操作 IteratorToList は、引数 iteratorRecord（
- values を新しい空の
リスト とする。 - 繰り返し：
- next を ?
IteratorStepValue (iteratorRecord) とする。 - もし next が
done なら、- values を返す。
- next を values に追加する。
- next を ?
8 構文指向操作
この節で定義されているものに加えて、特化された
8.1 実行時セマンティクス: 評価
8.2 スコープ解析
8.2.1 静的セマンティクス: BoundNames
これは以下の生成規則ごとに分割定義されています：
リスト を返す。その唯一の要素はStringValue であり、識別子 の値である。
- «
"yield" »を返す。
- «
"await" »を返す。
- 新しい空の
リスト を返す。
- names1 を
束縛名 （束縛プロパティリスト について）とする。 - names2 を
束縛名 （束縛残余プロパティ について）とする。 リスト連結 によって names1 と names2 を結合して返す。
- 新しい空の
リスト を返す。
- names1 を
束縛名 （束縛プロパティリスト について）とする。 - names2 を
束縛名 （束縛プロパティ について）とする。 リスト連結 によって names1 と names2 を結合して返す。
BoundNames をBindingIdentifier に対して返す。
- «
"*default*" » を返す。
- 新しい空の
List を返す。
- names1 を
BoundNames のFormalParameterList で取得する。 - names2 を
BoundNames のFunctionRestParameter で取得する。 -
names1 と names2 の
リスト連結 を返す。
- names1 を
BoundNames のFormalParameterList で取得する。 - names2 を
BoundNames のFormalParameter で取得する。 -
names1 と names2 の
リスト連結 を返す。
- formals を
ArrowFormalParameters で、cover されているCoverParenthesizedExpressionAndArrowParameterList から取得する。 - formals の
BoundNames を返す。
BoundNames をBindingIdentifier に対して返す。
- «
"*default*" » を返す。
BoundNames をBindingIdentifier に対して返す。
- «
"*default*" » を返す。
BoundNames をBindingIdentifier に対して返す。
- «
"*default*" » を返す。
BoundNames をBindingIdentifier に対して返す。
- «
"*default*" » を返す。
- head を
AsyncArrowHead で、cover されているCoverCallExpressionAndAsyncArrowHead から取得する。 - head の
BoundNames を返す。
BoundNames をImportClause に対して返す。
- 新しい空の
List を返す。
- names1 を
BoundNames のImportedDefaultBinding で取得する。 - names2 を
BoundNames のNameSpaceImport で取得する。 -
names1 と names2 の
リスト連結 を返す。
- names1 を
BoundNames のImportedDefaultBinding で取得する。 - names2 を
BoundNames のNamedImports で取得する。 -
names1 と names2 の
リスト連結 を返す。
- 新しい空の
List を返す。
- names1 を
BoundNames のImportsList で取得する。 - names2 を
BoundNames のImportSpecifier で取得する。 -
names1 と names2 の
リスト連結 を返す。
BoundNames をImportedBinding に対して返す。
- 新しい空の
List を返す。
BoundNames をVariableStatement に対して返す。
BoundNames をDeclaration に対して返す。
- declarationNames を
BoundNames のHoistableDeclaration で取得する。 - もし declarationNames に
"*default*" 要素が含まれていなければ、"*default*" を declarationNames に追加する。 - declarationNames を返す。
- declarationNames を
BoundNames のClassDeclaration で取得する。 - もし declarationNames に
"*default*" 要素が含まれていなければ、"*default*" を declarationNames に追加する。 - declarationNames を返す。
- «
"*default*" » を返す。
8.2.2 静的セマンティクス：DeclarationPart
FunctionDeclaration を返す。
GeneratorDeclaration を返す。
ClassDeclaration を返す。
LexicalDeclaration を返す。
8.2.3 静的セマンティクス：IsConstantDeclaration
IsConstantDeclaration をLetOrConst に対して返す。
false を返す。
true を返す。
false を返す。
false を返す。
false を返す。
export default
8.2.4 静的セマンティクス：LexicallyDeclaredNames
- 新しい空の
リスト を返す。
- names1 を
LexicallyDeclaredNames のStatementList で取得する。 - names2 を
LexicallyDeclaredNames のStatementListItem で取得する。 -
names1 と names2 の
リスト連結 を返す。
- もし
Statement がStatement ： LabelledStatement LexicallyDeclaredNames のLabelledStatement を返す。 - 新しい空の
リスト を返す。
BoundNames をDeclaration に対して返す。
- 新しい空の
リスト を返す。
- 最初の
CaseClauses が存在する場合、names1 をLexicallyDeclaredNames の最初のCaseClauses で取得する。 - そうでなければ、names1 を新しい空の
リスト とする。 - names2 を
LexicallyDeclaredNames のDefaultClause で取得する。 - 2番目の
CaseClauses が存在する場合、names3 をLexicallyDeclaredNames の2番目のCaseClauses で取得する。 - そうでなければ、names3 を新しい空の
リスト とする。 -
names1、names2、names3 の
リスト連結 を返す。
- names1 を
LexicallyDeclaredNames のCaseClauses で取得する。 - names2 を
LexicallyDeclaredNames のCaseClause で取得する。 -
names1 と names2 の
リスト連結 を返す。
StatementList が存在する場合、LexicallyDeclaredNames のStatementList を返す。- 新しい空の
リスト を返す。
StatementList が存在する場合、LexicallyDeclaredNames のStatementList を返す。- 新しい空の
リスト を返す。
LexicallyDeclaredNames をLabelledItem に対して返す。
- 新しい空の
リスト を返す。
BoundNames をFunctionDeclaration に対して返す。
- 新しい空の
リスト を返す。
TopLevelLexicallyDeclaredNames をStatementList に対して返す。
- 新しい空の
リスト を返す。
TopLevelLexicallyDeclaredNames をStatementList に対して返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
TopLevelLexicallyDeclaredNames をStatementList に対して返す。
- names1 を
LexicallyDeclaredNames のModuleItemList で取得する。 - names2 を
LexicallyDeclaredNames のModuleItem で取得する。 -
names1 と names2 の
リスト連結 を返す。
BoundNames をImportDeclaration に対して返す。
ExportDeclaration がexportVariableStatement の場合、新しい空のリスト を返す。BoundNames をExportDeclaration に対して返す。
LexicallyDeclaredNames をStatementListItem に対して返す。
8.2.5 静的セマンティクス：LexicallyScopedDeclarations
- declarations1 を
LexicallyScopedDeclarations のStatementList で取得する。 - declarations2 を
LexicallyScopedDeclarations のStatementListItem で取得する。 -
declarations1 と declarations2 の
リスト連結 を返す。
- もし
Statement がStatement ： LabelledStatement LexicallyScopedDeclarations のLabelledStatement を返す。 - 新しい空の
リスト を返す。
リスト （唯一の要素はDeclarationPart ofDeclaration ）を返す。
- 新しい空の
リスト を返す。
- 最初の
CaseClauses が存在する場合、declarations1 をLexicallyScopedDeclarations の最初のCaseClauses で取得する。 - そうでなければ、declarations1 を新しい空の
リスト とする。 - declarations2 を
LexicallyScopedDeclarations のDefaultClause で取得する。 - 2番目の
CaseClauses が存在する場合、declarations3 をLexicallyScopedDeclarations の2番目のCaseClauses で取得する。 - そうでなければ、declarations3 を新しい空の
リスト とする。 -
declarations1、declarations2、declarations3 の
リスト連結 を返す。
- declarations1 を
LexicallyScopedDeclarations のCaseClauses で取得する。 - declarations2 を
LexicallyScopedDeclarations のCaseClause で取得する。 -
declarations1 と declarations2 の
リスト連結 を返す。
StatementList が存在する場合、LexicallyScopedDeclarations のStatementList を返す。- 新しい空の
リスト を返す。
StatementList が存在する場合、LexicallyScopedDeclarations のStatementList を返す。- 新しい空の
リスト を返す。
LexicallyScopedDeclarations をLabelledItem に対して返す。
- 新しい空の
リスト を返す。
- «
FunctionDeclaration » を返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
- declarations1 を
LexicallyScopedDeclarations のModuleItemList で取得する。 - declarations2 を
LexicallyScopedDeclarations のModuleItem で取得する。 -
declarations1 と declarations2 の
リスト連結 を返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
リスト （唯一の要素はDeclarationPart ofDeclaration ）を返す。
リスト （唯一の要素はDeclarationPart ofHoistableDeclaration ）を返す。
リスト （唯一の要素はClassDeclaration ）を返す。
リスト （唯一の要素はこのExportDeclaration ）を返す。
8.2.6 静的セマンティクス：VarDeclaredNames
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
- names1 を
VarDeclaredNames のStatementList で取得する。 - names2 を
VarDeclaredNames のStatementListItem で取得する。 -
names1 と names2 の
リスト連結 を返す。
- 新しい空の
リスト を返す。
BoundNames をVariableDeclarationList に対して返す。
- names1 を
VarDeclaredNames の 最初のStatement で取得する。 - names2 を
VarDeclaredNames の 2番目のStatement で取得する。 -
names1 と names2 の
リスト連結 を返す。
VarDeclaredNames をStatement に対して返す。
VarDeclaredNames をStatement に対して返す。
VarDeclaredNames をStatement に対して返す。
VarDeclaredNames をStatement に対して返す。
- names1 を
BoundNames のVariableDeclarationList で取得する。 - names2 を
VarDeclaredNames のStatement で取得する。 -
names1 と names2 の
リスト連結 を返す。
VarDeclaredNames をStatement に対して返す。
VarDeclaredNames をStatement に対して返す。
- names1 を
BoundNames のForBinding で取得する。 - names2 を
VarDeclaredNames のStatement で取得する。 -
names1 と names2 の
リスト連結 を返す。
このセクションは付録
VarDeclaredNames をStatement に対して返す。
VarDeclaredNames をCaseBlock に対して返す。
- 新しい空の
リスト を返す。
- 最初の
CaseClauses が存在する場合、names1 をVarDeclaredNames の 最初のCaseClauses で取得する。 - そうでなければ、names1 を新しい空の
リスト とする。 - names2 を
VarDeclaredNames のDefaultClause で取得する。 - 2番目の
CaseClauses が存在する場合、names3 をVarDeclaredNames の 2番目のCaseClauses で取得する。 - そうでなければ、names3 を新しい空の
リスト とする。 -
names1、names2、names3 の
リスト連結 を返す。
- names1 を
VarDeclaredNames のCaseClauses で取得する。 - names2 を
VarDeclaredNames のCaseClause で取得する。 -
names1 と names2 の
リスト連結 を返す。
StatementList が存在する場合、VarDeclaredNames をStatementList に対して返す。- 新しい空の
リスト を返す。
StatementList が存在する場合、VarDeclaredNames をStatementList に対して返す。- 新しい空の
リスト を返す。
VarDeclaredNames をLabelledItem に対して返す。
- 新しい空の
リスト を返す。
- names1 を
VarDeclaredNames のBlock で取得する。 - names2 を
VarDeclaredNames のCatch で取得する。 -
names1 と names2 の
リスト連結 を返す。
- names1 を
VarDeclaredNames のBlock で取得する。 - names2 を
VarDeclaredNames のFinally で取得する。 -
names1 と names2 の
リスト連結 を返す。
- names1 を
VarDeclaredNames のBlock で取得する。 - names2 を
VarDeclaredNames のCatch で取得する。 - names3 を
VarDeclaredNames のFinally で取得する。 -
names1、names2、names3 の
リスト連結 を返す。
VarDeclaredNames をBlock に対して返す。
- 新しい空の
リスト を返す。
TopLevelVarDeclaredNames をStatementList に対して返す。
- 新しい空の
リスト を返す。
TopLevelVarDeclaredNames をStatementList に対して返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
TopLevelVarDeclaredNames をStatementList に対して返す。
- names1 を
VarDeclaredNames のModuleItemList で取得する。 - names2 を
VarDeclaredNames のModuleItem で取得する。 -
names1 と names2 の
リスト連結 を返す。
- 新しい空の
リスト を返す。
ExportDeclaration がexportVariableStatement の場合、BoundNames をExportDeclaration に対して返す。- 新しい空の
リスト を返す。
8.2.7 静的セマンティクス：VarScopedDeclarations
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
- declarations1 を
VarScopedDeclarations のStatementList で取得する。 - declarations2 を
VarScopedDeclarations のStatementListItem で取得する。 -
declarations1 と declarations2 の
リスト連結 を返す。
- 新しい空の
リスト を返す。
- «
VariableDeclaration » を返す。
- declarations1 を
VarScopedDeclarations のVariableDeclarationList で取得する。 -
declarations1 と «
VariableDeclaration » のリスト連結 を返す。
- declarations1 を
VarScopedDeclarations の最初のStatement で取得する。 - declarations2 を
VarScopedDeclarations の2番目のStatement で取得する。 -
declarations1 と declarations2 の
リスト連結 を返す。
VarScopedDeclarations をStatement に対して返す。
VarScopedDeclarations をStatement に対して返す。
VarScopedDeclarations をStatement に対して返す。
VarScopedDeclarations をStatement に対して返す。
- declarations1 を
VarScopedDeclarations のVariableDeclarationList で取得する。 - declarations2 を
VarScopedDeclarations のStatement で取得する。 -
declarations1 と declarations2 の
リスト連結 を返す。
VarScopedDeclarations をStatement に対して返す。
VarScopedDeclarations をStatement に対して返す。
- declarations1 を «
ForBinding » とする。 - declarations2 を
VarScopedDeclarations のStatement で取得する。 -
declarations1 と declarations2 の
リスト連結 を返す。
このセクションは付属書
VarScopedDeclarations をStatement に対して返す。
VarScopedDeclarations をCaseBlock に対して返す。
- 新しい空の
リスト を返す。
- 最初の
CaseClauses が存在する場合、declarations1 をVarScopedDeclarations の最初のCaseClauses で取得する。 - そうでなければ、declarations1 を新しい空の
リスト とする。 - declarations2 を
VarScopedDeclarations のDefaultClause で取得する。 - 2番目の
CaseClauses が存在する場合、declarations3 をVarScopedDeclarations の2番目のCaseClauses で取得する。 - そうでなければ、declarations3 を新しい空の
リスト とする。 -
declarations1、declarations2、declarations3 の
リスト連結 を返す。
- declarations1 を
VarScopedDeclarations のCaseClauses で取得する。 - declarations2 を
VarScopedDeclarations のCaseClause で取得する。 -
declarations1 と declarations2 の
リスト連結 を返す。
StatementList が存在する場合、VarScopedDeclarations のStatementList を返す。- 新しい空の
リスト を返す。
StatementList が存在する場合、VarScopedDeclarations のStatementList を返す。- 新しい空の
リスト を返す。
VarScopedDeclarations をLabelledItem に対して返す。
- 新しい空の
リスト を返す。
- declarations1 を
VarScopedDeclarations のBlock で取得する。 - declarations2 を
VarScopedDeclarations のCatch で取得する。 -
declarations1 と declarations2 の
リスト連結 を返す。
- declarations1 を
VarScopedDeclarations のBlock で取得する。 - declarations2 を
VarScopedDeclarations のFinally で取得する。 -
declarations1 と declarations2 の
リスト連結 を返す。
- declarations1 を
VarScopedDeclarations のBlock で取得する。 - declarations2 を
VarScopedDeclarations のCatch で取得する。 - declarations3 を
VarScopedDeclarations のFinally で取得する。 -
declarations1、declarations2、declarations3 の
リスト連結 を返す。
VarScopedDeclarations をBlock に対して返す。
- 新しい空の
リスト を返す。
TopLevelVarScopedDeclarations をStatementList に対して返す。
- 新しい空の
リスト を返す。
TopLevelVarScopedDeclarations をStatementList に対して返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
TopLevelVarScopedDeclarations をStatementList に対して返す。
- 新しい空の
リスト を返す。
- declarations1 を
VarScopedDeclarations のModuleItemList で取得する。 - declarations2 を
VarScopedDeclarations のModuleItem で取得する。 -
declarations1 と declarations2 の
リスト連結 を返す。
- 新しい空の
リスト を返す。
ExportDeclaration がexportVariableStatement の場合、VarScopedDeclarations をVariableStatement に対して返す。- 新しい空の
リスト を返す。
8.2.8 静的セマンティクス：TopLevelLexicallyDeclaredNames
- names1を、
TopLevelLexicallyDeclaredNames のStatementList に対する値とする。 - names2を、
TopLevelLexicallyDeclaredNames のStatementListItem に対する値とする。 リスト連結 で names1とnames2を返す。
- 新しい空の
リスト を返す。
- もし
Declaration がDeclaration : HoistableDeclaration - 新しい空の
リスト を返す。
- 新しい空の
BoundNames のDeclaration に対する値を返す。
関数またはスクリプトのトップレベルでは、function宣言はレキシカル宣言ではなくvar宣言として扱われる。
8.2.9 静的セマンティクス：TopLevelLexicallyScopedDeclarations
- declarations1を、
TopLevelLexicallyScopedDeclarations のStatementList に対する値とする。 - declarations2を、
TopLevelLexicallyScopedDeclarations のStatementListItem に対する値とする。 リスト連結 で declarations1とdeclarations2を返す。
- 新しい空の
リスト を返す。
- もし
Declaration がDeclaration : HoistableDeclaration - 新しい空の
リスト を返す。
- 新しい空の
- «
Declaration » を返す。
8.2.10 静的セマンティクス：TopLevelVarDeclaredNames
- names1を、
TopLevelVarDeclaredNames のStatementList に対する値とする。 - names2を、
TopLevelVarDeclaredNames のStatementListItem に対する値とする。 リスト連結 で names1とnames2を返す。
- もし
Declaration がDeclaration : HoistableDeclaration BoundNames のHoistableDeclaration に対する値を返す。
- 新しい空の
リスト を返す。
- もし
Statement がStatement : LabelledStatement TopLevelVarDeclaredNames のStatement に対する値を返す。 VarDeclaredNames のStatement に対する値を返す。
関数やスクリプトのトップレベルでは、内部のfunction宣言はvar宣言として扱われる。
TopLevelVarDeclaredNames のLabelledItem に対する値を返す。
- もし
Statement がStatement : LabelledStatement TopLevelVarDeclaredNames のStatement に対する値を返す。 VarDeclaredNames のStatement に対する値を返す。
BoundNames のFunctionDeclaration に対する値を返す。
8.2.11 静的セマンティクス：TopLevelVarScopedDeclarations
- declarations1を、
TopLevelVarScopedDeclarations のStatementList に対する値とする。 - declarations2を、
TopLevelVarScopedDeclarations のStatementListItem に対する値とする。 リスト連結 で declarations1とdeclarations2を返す。
- もし
Statement がStatement : LabelledStatement TopLevelVarScopedDeclarations のStatement に対する値を返す。 VarScopedDeclarations のStatement に対する値を返す。
- もし
Declaration がDeclaration : HoistableDeclaration - declarationを
DeclarationPart のHoistableDeclaration に対する値とする。 - « declaration » を返す。
- declarationを
- 新しい空の
リスト を返す。
TopLevelVarScopedDeclarations のLabelledItem に対する値を返す。
- もし
Statement がStatement : LabelledStatement TopLevelVarScopedDeclarations のStatement に対する値を返す。 VarScopedDeclarations のStatement に対する値を返す。
- «
FunctionDeclaration » を返す。
8.3 ラベル
8.3.1 静的セマンティクス：ContainsDuplicateLabels
false を返す。
- hasDuplicatesを
ContainsDuplicateLabels のStatementList にlabelSetを引数として適用した結果とする。 - もしhasDuplicatesが
true なら、true を返す。 ContainsDuplicateLabels のStatementListItem にlabelSetを引数として適用した結果を返す。
- hasDuplicateを、最初の
Statement にlabelSetを引数としてContainsDuplicateLabels を適用した結果とする。 - もしhasDuplicateが
true なら、true を返す。 - 2番目の
Statement にlabelSetを引数としてContainsDuplicateLabels を適用した結果を返す。
ContainsDuplicateLabels をStatement にlabelSetを引数として適用した結果を返す。
ContainsDuplicateLabels をStatement にlabelSetを引数として適用した結果を返す。
ContainsDuplicateLabels をStatement にlabelSetを引数として適用した結果を返す。
ContainsDuplicateLabels をStatement にlabelSetを引数として適用した結果を返す。
ContainsDuplicateLabels のStatement にlabelSetを引数として適用した結果を返す。
このセクションは付録
ContainsDuplicateLabels をStatement にlabelSetを引数として適用した結果を返す。
ContainsDuplicateLabels をCaseBlock にlabelSetを引数として適用した結果を返す。
false を返す。
- 最初の
CaseClauses が存在する場合、- 最初の
CaseClauses にlabelSetを引数としてContainsDuplicateLabels を適用した結果がtrue なら、true を返す。
- 最初の
DefaultClause にlabelSetを引数としてContainsDuplicateLabels を適用した結果がtrue なら、true を返す。- 2番目の
CaseClauses が存在しなければ、false を返す。 - 2番目の
CaseClauses にlabelSetを引数としてContainsDuplicateLabels を適用した結果を返す。
- hasDuplicatesを
ContainsDuplicateLabels のCaseClauses にlabelSetを引数として適用した結果とする。 - もしhasDuplicatesが
true なら、true を返す。 ContainsDuplicateLabels をCaseClause にlabelSetを引数として適用した結果を返す。
StatementList が存在する場合、ContainsDuplicateLabels をStatementList にlabelSetを引数として適用した結果を返す。false を返す。
StatementList が存在する場合、ContainsDuplicateLabels をStatementList にlabelSetを引数として適用した結果を返す。false を返す。
- labelを
LabelIdentifier のStringValue とする。 - もしlabelSetがlabelを含むなら、
true を返す。 - newLabelSetを
list-concatenation によりlabelSetと« label »の連結とする。 ContainsDuplicateLabels をLabelledItem にnewLabelSetを引数として適用した結果を返す。
false を返す。
- hasDuplicates に
ContainsDuplicateLabels のブロック と引数 labelSet を設定する。 - hasDuplicates が
true の場合、true を返す。 ContainsDuplicateLabels のcatch節 と引数 labelSet を返す。
- hasDuplicates に
ContainsDuplicateLabels のブロック と引数 labelSet を設定する。 - hasDuplicates が
true の場合、true を返す。 ContainsDuplicateLabels のfinally節 と引数 labelSet を返す。
ContainsDuplicateLabels のブロック と引数 labelSet がtrue の場合、true を返す。ContainsDuplicateLabels のcatch節 と引数 labelSet がtrue の場合、true を返す。ContainsDuplicateLabels のfinally節 と引数 labelSet を返す。
ContainsDuplicateLabels のブロック と引数 labelSet を返す。
false を返す。
false を返す。
- hasDuplicates に
ContainsDuplicateLabels のモジュール項目リスト と引数 labelSet を設定する。 - hasDuplicates が
true の場合、true を返す。 ContainsDuplicateLabels のモジュール項目 と引数 labelSet を返す。
false を返す。
8.3.2 静的セマンティクス: ContainsUndefinedBreakTarget
false を返す。
- hasUndefinedLabels に
ContainsUndefinedBreakTarget ofStatementList を引数 labelSet で適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 ContainsUndefinedBreakTarget ofStatementListItem を引数 labelSet で適用した結果を返す。
- hasUndefinedLabels に、最初の
Statement に labelSet を渡してContainsUndefinedBreakTarget を適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 - 2つ目の
Statement に labelSet を渡してContainsUndefinedBreakTarget を適用した結果を返す。
ContainsUndefinedBreakTarget をStatement に labelSet を渡して適用した結果を返す。
ContainsUndefinedBreakTarget をStatement に labelSet を渡して適用した結果を返す。
ContainsUndefinedBreakTarget をStatement に labelSet を渡して適用した結果を返す。
ContainsUndefinedBreakTarget をStatement に labelSet を渡して適用した結果を返す。
ContainsUndefinedBreakTarget をStatement に labelSet を渡して適用した結果を返す。
本節は付録
false を返す。
- もし labelSet に
LabelIdentifier のStringValue が含まれていなければ、true を返す。 false を返す。
ContainsUndefinedBreakTarget をStatement に labelSet を渡して適用した結果を返す。
ContainsUndefinedBreakTarget をCaseBlock に labelSet を渡して適用した結果を返す。
false を返す。
- 最初の
CaseClauses が存在する場合、- もし
ContainsUndefinedBreakTarget of 最初のCaseClauses に labelSet を渡して適用した結果がtrue なら、true を返す。
- もし
ContainsUndefinedBreakTarget ofDefaultClause に labelSet を渡して適用した結果がtrue なら、true を返す。- 2つ目の
CaseClauses が存在しない場合、false を返す。 ContainsUndefinedBreakTarget of 2つ目のCaseClauses に labelSet を渡して適用した結果を返す。
- hasUndefinedLabels に
ContainsUndefinedBreakTarget ofCaseClauses に labelSet を渡して適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 ContainsUndefinedBreakTarget ofCaseClause に labelSet を渡して適用した結果を返す。
StatementList が存在する場合、ContainsUndefinedBreakTarget ofStatementList に labelSet を渡して適用した結果を返す。false を返す。
StatementList が存在する場合、ContainsUndefinedBreakTarget ofStatementList に labelSet を渡して適用した結果を返す。false を返す。
- label に
LabelIdentifier のStringValue を代入する。 - newLabelSet に
labelSet と « label » のリスト連結を代入する。 ContainsUndefinedBreakTarget をLabelledItem に newLabelSet を渡して適用した結果を返す。
false を返す。
- hasUndefinedLabels に
ContainsUndefinedBreakTarget ofBlock に labelSet を渡して適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 ContainsUndefinedBreakTarget ofCatch に labelSet を渡して適用した結果を返す。
- hasUndefinedLabels に
ContainsUndefinedBreakTarget ofBlock に labelSet を渡して適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 ContainsUndefinedBreakTarget ofFinally に labelSet を渡して適用した結果を返す。
ContainsUndefinedBreakTarget ofBlock に labelSet を渡して適用した結果がtrue なら、true を返す。ContainsUndefinedBreakTarget ofCatch に labelSet を渡して適用した結果がtrue なら、true を返す。ContainsUndefinedBreakTarget ofFinally に labelSet を渡して適用した結果を返す。
ContainsUndefinedBreakTarget ofBlock に labelSet を渡して適用した結果を返す。
false を返す。
false を返す。
- hasUndefinedLabels に
ContainsUndefinedBreakTarget ofModuleItemList に labelSet を渡して適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 ContainsUndefinedBreakTarget ofModuleItem に labelSet を渡して適用した結果を返す。
false を返す。
8.3.3 静的セマンティクス: ContainsUndefinedContinueTarget
false を返す。
ContainsUndefinedContinueTarget をBlockStatement に iterationSet および « » を渡して適用した結果を返す。
- newIterationSet に
iterationSet と labelSet のリスト連結を代入する。 ContainsUndefinedContinueTarget をIterationStatement に newIterationSet および « » を渡して適用した結果を返す。
- hasUndefinedLabels に
ContainsUndefinedContinueTarget ofStatementList に iterationSet および « » を渡して適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 ContainsUndefinedContinueTarget ofStatementListItem に iterationSet および « » を渡して適用した結果を返す。
- hasUndefinedLabels に
ContainsUndefinedContinueTarget of 最初のStatement に iterationSet および « » を渡して適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 - 2つ目の
Statement に iterationSet および « » を渡してContainsUndefinedContinueTarget を適用した結果を返す。
ContainsUndefinedContinueTarget をStatement に iterationSet および « » を渡して適用した結果を返す。
ContainsUndefinedContinueTarget をStatement に iterationSet および « » を渡して適用した結果を返す。
ContainsUndefinedContinueTarget をStatement に iterationSet および « » を渡して適用した結果を返す。
ContainsUndefinedContinueTarget をStatement に iterationSet および « » を渡して適用した結果を返す。
ContainsUndefinedContinueTarget をStatement に iterationSet および « » を渡して適用した結果を返す。
本節は付録
false を返す。
- もし iterationSet に
LabelIdentifier のStringValue が含まれていなければ、true を返す。 false を返す。
ContainsUndefinedContinueTarget をStatement に iterationSet および « » を渡して適用した結果を返す。
ContainsUndefinedContinueTarget をCaseBlock に iterationSet および « » を渡して適用した結果を返す。
false を返す。
- 最初の
CaseClauses が存在する場合、- もし
ContainsUndefinedContinueTarget of 最初のCaseClauses に iterationSet および « » を渡して適用した結果がtrue なら、true を返す。
- もし
ContainsUndefinedContinueTarget ofDefaultClause に iterationSet および « » を渡して適用した結果がtrue なら、true を返す。- 2つ目の
CaseClauses が存在しない場合、false を返す。 ContainsUndefinedContinueTarget of 2つ目のCaseClauses に iterationSet および « » を渡して適用した結果を返す。
- hasUndefinedLabels に
ContainsUndefinedContinueTarget ofCaseClauses に iterationSet および « » を渡して適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 ContainsUndefinedContinueTarget ofCaseClause に iterationSet および « » を渡して適用した結果を返す。
StatementList が存在する場合、ContainsUndefinedContinueTarget ofStatementList に iterationSet および « » を渡して適用した結果を返す。false を返す。
StatementList が存在する場合、ContainsUndefinedContinueTarget ofStatementList に iterationSet および « » を渡して適用した結果を返す。false を返す。
- label に
LabelIdentifier のStringValue を代入する。 - newLabelSet に
labelSet と « label » のリスト連結を代入する。 ContainsUndefinedContinueTarget をLabelledItem に iterationSet および newLabelSet を渡して適用した結果を返す。
false を返す。
- hasUndefinedLabels に
ContainsUndefinedContinueTarget ofBlock に iterationSet および « » を渡して適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 ContainsUndefinedContinueTarget ofCatch に iterationSet および « » を渡して適用した結果を返す。
- hasUndefinedLabels に
ContainsUndefinedContinueTarget ofBlock に iterationSet および « » を渡して適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 ContainsUndefinedContinueTarget ofFinally に iterationSet および « » を渡して適用した結果を返す。
ContainsUndefinedContinueTarget ofBlock に iterationSet および « » を渡して適用した結果がtrue なら、true を返す。ContainsUndefinedContinueTarget ofCatch に iterationSet および « » を渡して適用した結果がtrue なら、true を返す。ContainsUndefinedContinueTarget ofFinally に iterationSet および « » を渡して適用した結果を返す。
ContainsUndefinedContinueTarget ofBlock に iterationSet および « » を渡して適用した結果を返す。
false を返す。
false を返す。
- hasUndefinedLabels に
ContainsUndefinedContinueTarget ofModuleItemList に iterationSet および « » を渡して適用した結果を代入する。 - もし hasUndefinedLabels が
true なら、true を返す。 ContainsUndefinedContinueTarget ofModuleItem に iterationSet および « » を渡して適用した結果を返す。
false を返す。
8.4 関数名の推論
8.4.1 静的セマンティクス: HasName
- expr を
ParenthesizedExpression （CoverParenthesizedExpressionAndArrowParameterList によってカバーされている もの）とする。 IsFunctionDefinition of expr がfalse なら、false を返す。HasName of expr を返す。
false を返す。
true を返す。
8.4.2 静的セマンティクス: IsFunctionDefinition
- expr を
ParenthesizedExpression （CoverParenthesizedExpressionAndArrowParameterList によりカバーされている もの）とする。 IsFunctionDefinition of expr を返す。
false を返す。
true を返す。
8.4.3 静的セマンティクス: IsAnonymousFunctionDefinition (expr)
抽象オペレーション IsAnonymousFunctionDefinition は引数 expr（
IsFunctionDefinition of expr がfalse なら、false を返す。- hasName に
HasName of expr を代入する。 - hasName が
true なら、false を返す。 true を返す。
8.4.4 静的セマンティクス: IsIdentifierRef
true を返す。
false を返す。
8.4.5 実行時セマンティクス: NamedEvaluation
- expr を
ParenthesizedExpression （CoverParenthesizedExpressionAndArrowParameterList によりカバーされている もの）とする。 - ?
NamedEvaluation of expr に引数 name を渡して返す。
アサート :IsAnonymousFunctionDefinition (Expression ) がtrue であること。- ?
NamedEvaluation ofExpression に引数 name を渡して返す。
InstantiateOrdinaryFunctionExpression ofFunctionExpression に引数 name を渡して返す。
InstantiateGeneratorFunctionExpression ofGeneratorExpression に引数 name を渡して返す。
InstantiateAsyncGeneratorFunctionExpression ofAsyncGeneratorExpression に引数 name を渡して返す。
InstantiateAsyncFunctionExpression ofAsyncFunctionExpression に引数 name を渡して返す。
InstantiateArrowFunctionExpression ofArrowFunction に引数 name を渡して返す。
InstantiateAsyncArrowFunctionExpression ofAsyncArrowFunction に引数 name を渡して返す。
- value に ?
ClassDefinitionEvaluation ofClassTail に引数undefined と name を渡して返す。 - value.[[SourceText]] に
ClassExpression にマッチしたソーステキストを設定する。 - value を返す。
8.5 含む
8.5.1 静的セマンティクス: Contains
本仕様において、以下に列挙されていないすべての文法生成規則の選択肢は、暗黙的に次のデフォルトのContains定義を持つ：
false を返す。
サブ構造に依存する静的セマンティクス規則は、一般的に関数定義の内部は調べない。
- もしsymbolが
ClassBody であれば、true を返す。 - もしsymbolが
ClassHeritage であれば、- もし
ClassHeritage が存在すればtrue 、そうでなければfalse を返す。
- もし
- もし
ClassHeritage が存在すれば、- もし
ClassHeritage Contains symbolがtrue であれば、true を返す。
- もし
ComputedPropertyContains をClassBody と引数symbolで呼び出した結果を返す。
サブ構造に依存する静的セマンティクス規則は、一般的にクラス本体の内部は
false を返す。
サブ構造に依存する静的セマンティクス規則は、一般的にstatic 初期化ブロックの内部は調べない。
- もしsymbolが
NewTarget 、SuperProperty 、SuperCall 、super、またはthisのいずれでもなければ、false を返す。 - もし
ArrowParameters Contains symbol がtrue であれば、true を返す。 ConciseBody Contains symbolの結果を返す。
- formalsを
ArrowFormalParameters とし、それは被覆 されているCoverParenthesizedExpressionAndArrowParameterList に対応する。 - formals
Contains symbolの結果を返す。
- もしsymbolが
NewTarget 、SuperProperty 、SuperCall 、super、またはthisのいずれでもなければ、false を返す。 AsyncConciseBody Contains symbolの結果を返す。
- もしsymbolが
NewTarget 、SuperProperty 、SuperCall 、super、またはthisのいずれでもなければ、false を返す。 - headを
AsyncArrowHead とし、それは被覆 されているCoverCallExpressionAndAsyncArrowHead に対応する。 - もしhead
Contains symbol がtrue であれば、true を返す。 AsyncConciseBody Contains symbolの結果を返す。
Containsはnew.target、this、およびsuperの使用を検出するために利用される。
- もしsymbolが
MethodDefinition であれば、true を返す。 ComputedPropertyContains をMethodDefinition と引数symbolで呼び出した結果を返す。
false を返す。
- もし
MemberExpression Contains symbol がtrue であれば、true を返す。 false を返す。
- もしsymbolが
ReservedWord superであれば、true を返す。 false を返す。
- もし
CallExpression Contains symbol がtrue であれば、true を返す。 false を返す。
false を返す。
- もし
OptionalChain Contains symbol がtrue であれば、true を返す。 false を返す。
8.5.2 静的セマンティクス: ComputedPropertyContains
false を返す。
ComputedPropertyName Contains symbolの結果を返す。
ComputedPropertyContains をClassElementName と引数symbolで呼び出した結果を返す。
ComputedPropertyContains をClassElementName と引数symbolで呼び出した結果を返す。
ComputedPropertyContains をClassElementName と引数symbolで呼び出した結果を返す。
- inListを
ComputedPropertyContains をClassElementList と引数symbolで呼び出した結果とする。 - もしinListが
true であれば、true を返す。 ComputedPropertyContains をClassElement と引数symbolで呼び出した結果を返す。
false を返す。
false を返す。
ComputedPropertyContains をClassElementName と引数symbolで呼び出した結果を返す。
ComputedPropertyContains をClassElementName と引数symbolで呼び出した結果を返す。
8.6 その他
これらの操作は、仕様書の複数の箇所で使用されます。
8.6.1 実行時セマンティクス: InstantiateFunctionObject
-
InstantiateOrdinaryFunctionObject をFunctionDeclaration 、引数 env および privateEnv で呼び出した結果を返す。
-
InstantiateGeneratorFunctionObject をGeneratorDeclaration 、引数 env および privateEnv で呼び出した結果を返す。
-
InstantiateAsyncGeneratorFunctionObject をAsyncGeneratorDeclaration 、引数 env および privateEnv で呼び出した結果を返す。
-
InstantiateAsyncFunctionObject をAsyncFunctionDeclaration 、引数 env および privateEnv で呼び出した結果を返す。
8.6.2 実行時セマンティクス: BindingInitialization
これは以下の生成規則ごとに定義される:
-
name を
StringValue （Identifier の）とする。 -
InitializeBoundName (name, value, environment) を実行し、その結果を返す（?付き）。
-
InitializeBoundName ("yield" , value, environment) を実行し、その結果を返す（?付き）。
-
InitializeBoundName ("await" , value, environment) を実行し、その結果を返す（?付き）。
-
?
RequireObjectCoercible (value) を実行する。 -
BindingInitialization ofObjectBindingPattern （引数 value と environment） を実行し、その結果を返す（?付き）。
-
iteratorRecord を
?
GetIterator (value,sync ) とする。 -
result を
Completion (IteratorBindingInitialization ofArrayBindingPattern （引数 iteratorRecord と environment）) とする。 -
iteratorRecord.[[Done]] が
false の場合、?IteratorClose (iteratorRecord, result) を返す。 - ? result を返す。
unused を返す。
-
?
PropertyBindingInitialization ofBindingPropertyList （引数 value と environment）を実行する。 unused を返す。
-
excludedNames を新しい空の
List とする。 -
RestBindingInitialization ofBindingRestProperty （引数 value, environment, excludedNames） を実行し、その結果を返す（?付き）。
-
excludedNames を
?
PropertyBindingInitialization ofBindingPropertyList （引数 value と environment）の結果とする。 -
RestBindingInitialization ofBindingRestProperty （引数 value, environment, excludedNames） を実行し、その結果を返す（?付き）。
8.6.2.1 InitializeBoundName ( name, value, environment )
抽象操作 InitializeBoundName は、引数 name（文字列）、value（
-
environment が
undefined でない場合、- ! environment.InitializeBinding(name, value) を実行する。
unused を返す。
- それ以外の場合、
-
lhs を
?
ResolveBinding (name) とする。 -
?
PutValue (lhs, value) を返す。
-
lhs を
?
8.6.3 実行時セマンティクス: IteratorBindingInitialization
これは以下の生成規則ごとに定義される:
unused を返す。
-
?
IteratorDestructuringAssignmentEvaluation ofElision （引数 iteratorRecord） を実行し、その結果を返す。
-
Elision が存在する場合、-
?
IteratorDestructuringAssignmentEvaluation ofElision （引数 iteratorRecord） を実行する。
-
?
-
?
IteratorBindingInitialization ofBindingRestElement （引数 iteratorRecord および environment）を実行し、その結果を返す。
-
?
IteratorBindingInitialization ofBindingElementList （引数 iteratorRecord および environment）を実行する。 -
?
IteratorDestructuringAssignmentEvaluation ofElision （引数 iteratorRecord） を実行し、その結果を返す。
-
?
IteratorBindingInitialization ofBindingElementList （引数 iteratorRecord および environment）を実行する。 -
Elision が存在する場合、-
?
IteratorDestructuringAssignmentEvaluation ofElision （引数 iteratorRecord） を実行する。
-
?
-
?
IteratorBindingInitialization ofBindingRestElement （引数 iteratorRecord および environment）を実行し、その結果を返す。
-
?
IteratorBindingInitialization ofBindingElementList （引数 iteratorRecord および environment）を実行する。 -
?
IteratorBindingInitialization ofBindingElisionElement （引数 iteratorRecord および environment）を実行し、その結果を返す。
-
?
IteratorDestructuringAssignmentEvaluation ofElision （引数 iteratorRecord） を実行する。 -
?
IteratorBindingInitialization ofBindingElement （引数 iteratorRecord および environment）を実行し、その結果を返す。
-
bindingId を
StringValue ofBindingIdentifier とする。 -
lhs を
?
ResolveBinding (bindingId, environment) とする。 - v を
undefined とする。 -
iteratorRecord.[[Done]] が
false の場合、-
next を
?
IteratorStepValue (iteratorRecord) とする。 -
next が
done でない場合、- v に next を設定する。
-
next を
?
-
Initializer が存在し、 v がundefined の場合、-
IsAnonymousFunctionDefinition (Initializer ) がtrue の場合、-
v に
?
NamedEvaluation ofInitializer （引数 bindingId ）の結果を設定する。
-
v に
?
-
それ以外の場合、
-
defaultValue を
?
Evaluation ofInitializer の結果とする。 -
v に
?
GetValue (defaultValue) の結果を設定する。
-
defaultValue を
?
-
-
environment が
undefined の場合、 ?PutValue (lhs, v) を返す。 -
?
InitializeReferencedBinding (lhs, v) を返す。
- v を
undefined とする。 -
iteratorRecord.[[Done]] が
false の場合、-
next を
?
IteratorStepValue (iteratorRecord) とする。 -
next が
done でない場合、- v に next を設定する。
-
next を
?
-
Initializer が存在し、 v がundefined の場合、-
defaultValue を
?
Evaluation ofInitializer の結果とする。 -
v に
?
GetValue (defaultValue) の結果を設定する。
-
defaultValue を
?
-
?
BindingInitialization ofBindingPattern （引数 v および environment）を実行し、その結果を返す。
-
lhs を
?
ResolveBinding (StringValue ofBindingIdentifier , environment) とする。 -
A を
!
ArrayCreate (0) とする。 - n を 0 とする。
-
繰り返し、
- next を
done とする。 -
iteratorRecord.[[Done]] が
false の場合、-
next に
?
IteratorStepValue (iteratorRecord) を設定する。
-
next に
?
-
next が
done の場合、-
environment が
undefined なら ?PutValue (lhs, A) を返す。 -
?
InitializeReferencedBinding (lhs, A) を返す。
-
environment が
-
!
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), next) を実行する。 - n を n + 1 に設定する。
- next を
-
A を
!
ArrayCreate (0) とする。 - n を 0 とする。
-
繰り返し、
- next を
done とする。 -
iteratorRecord.[[Done]] が
false の場合、-
next に
?
IteratorStepValue (iteratorRecord) を設定する。
-
next に
?
-
next が
done の場合、-
?
BindingInitialization ofBindingPattern （引数 A および environment）を実行し、その結果を返す。
-
?
-
!
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), next) を実行する。 - n を n + 1 に設定する。
- next を
unused を返す。
-
?
IteratorBindingInitialization ofFormalParameterList （引数 iteratorRecord および environment）を実行する。 -
?
IteratorBindingInitialization ofFunctionRestParameter （引数 iteratorRecord および environment）を実行し、その結果を返す。
-
?
IteratorBindingInitialization ofFormalParameterList （引数 iteratorRecord および environment）を実行する。 -
?
IteratorBindingInitialization ofFormalParameter （引数 iteratorRecord および environment）を実行し、その結果を返す。
- v を
undefined とする。 -
Assert : iteratorRecord.[[Done]] はfalse である。 -
next を
?
IteratorStepValue (iteratorRecord) とする。 -
next が
done でない場合、- v に next を設定する。
-
?
BindingInitialization ofBindingIdentifier （引数 v および environment）を実行し、その結果を返す。
-
formals を
ArrowFormalParameters （CoverParenthesizedExpressionAndArrowParameterList によりcover される）とする。 -
?
IteratorBindingInitialization of formals（引数 iteratorRecord および environment）を実行し、その結果を返す。
- v を
undefined とする。 -
Assert : iteratorRecord.[[Done]] はfalse である。 -
next を
?
IteratorStepValue (iteratorRecord) とする。 -
next が
done でない場合、- v に next を設定する。
-
?
BindingInitialization ofBindingIdentifier （引数 v および environment）を実行し、その結果を返す。
8.6.4 静的セマンティクス: AssignmentTargetType
-
IsStrict (このIdentifierReference ) がtrue であり、かつStringValue ofIdentifier が"eval" または"arguments" のいずれかである場合、invalid を返す。 simple を返す。
simple を返す。
-
expr を
ParenthesizedExpression （CoverParenthesizedExpressionAndArrowParameterList によりcover されたもの）とする。 -
expr の
AssignmentTargetType を返す。
-
ホスト がウェブブラウザーであるか、または関数呼び出し代入ターゲットの実行時エラー をサポートしており、IsStrict (このCallExpression ) がfalse の場合、web-compat を返す。
invalid を返す。
invalid を返す。
8.6.5 静的セマンティクス: PropName
-
IdentifierReference のStringValue を返す。
empty を返す。
-
PropertyName のPropName を返す。
-
IdentifierName のStringValue を返す。
-
StringLiteral のSV を返す。
-
nbr を
NumericLiteral のNumericValue とする。 -
!
ToString (nbr) を返す。
empty を返す。
-
ClassElementName のPropName を返す。
-
ClassElementName のPropName を返す。
-
ClassElementName のPropName を返す。
empty を返す。
empty を返す。
-
ClassElementName のPropName を返す。
-
ClassElementName のPropName を返す。
empty を返す。
9 実行可能コードと実行コンテキスト
9.1 環境レコード
Environment Record
は、ECMAScriptコードの字句的なネスト構造に基づいて、
すべての Environment Record には [[OuterEnv]] フィールドがあり、これは
Environment Record は純粋に仕様上の仕組みであり、ECMAScript 実装の特定のアーティファクトに対応している必要はありません。ECMAScript プログラムがこれらの値に直接アクセスしたり操作することはできません。
9.1.1 環境レコード型の階層
-
-
宣言的環境レコード は、FunctionDeclaration 、VariableDeclaration 、Catch 節などの ECMAScript 言語構文要素の効果を、識別子バインディングをECMAScript 言語値 に直接関連付けることで定義するために使用されます。-
関数環境レコード は、ECMAScript の関数オブジェクト の呼び出しに対応し、その関数内のトップレベル宣言に対するバインディングを含みます。新しいthisバインディングを確立することができます。また、superメソッド呼び出しをサポートするために必要な状態も保持します。 -
モジュール環境レコード は、Module のトップレベル宣言のバインディングを持ちます。また、Module によって明示的にインポートされたバインディングも含まれます。その [[OuterEnv]] はグローバル環境レコード です。
-
-
オブジェクト環境レコード は、WithStatement のような ECMAScript の要素が、識別子バインディングをあるオブジェクトのプロパティに関連付ける効果を定義するために使用されます。 -
グローバル環境レコード は、Script のグローバル宣言のために使用されます。これは外側環境を持たず、その [[OuterEnv]] はnull です。識別子バインディングを事前に持つ場合があり、またグローバルオブジェクト が関連付けられており、そのプロパティがグローバル環境の識別子バインディングの一部を提供します。ECMAScript コードの実行により、グローバルオブジェクト に追加のプロパティが追加されたり、初期プロパティが変更されたりします。
-
| メソッド | 目的 |
|---|---|
| HasBinding(N) |
|
| CreateMutableBinding(N, D) |
|
| CreateImmutableBinding(N, S) |
|
| InitializeBinding(N, V) |
|
| SetMutableBinding(N, V, S) |
|
| GetBindingValue(N, S) |
|
| DeleteBinding(N) |
|
| HasThisBinding() |
this バインディングを確立するかどうか判定する。確立する場合は
|
| HasSuperBinding() |
super メソッドバインディングを確立するかどうか判定する。確立する場合は
|
| WithBaseObject() |
この with 文に関連付けられている場合は、その with オブジェクトを返す。それ以外の場合は
|
9.1.1.1 宣言的環境レコード
各宣言的環境レコードは、変数、定数、let、class、module、import、関数宣言を含むECMAScriptプログラムスコープに関連付けられています。宣言的環境レコードは、そのスコープ内に含まれる宣言によって定義された識別子の集合をバインドします。
9.1.1.1.1 HasBinding ( N )
- もし envRec が N のバインディングを持っていれば、
true を返す。 false を返す。
9.1.1.1.2 CreateMutableBinding ( N, D )
アサート : envRec は既に N のバインディングを持っていない。- envRec に N の可変バインディングを作成し、未初期化であることを記録する。D が
true なら、作成したバインディングが後続の DeleteBinding 呼び出しにより削除可能であることを記録する。 unused を返す。
9.1.1.1.3 CreateImmutableBinding ( N, S )
アサート : envRec は既に N のバインディングを持っていない。- envRec に N の不変バインディングを作成し、未初期化であることを記録する。S が
true なら、作成したバインディングが strict バインディングであることを記録する。 unused を返す。
9.1.1.1.4 InitializeBinding ( N, V )
アサート : envRec は N の未初期化バインディングを持っていること。- envRec の N のバインディング値を V に設定する。
記録 ：envRec の N のバインディングが初期化済みであることを記録する。unused を返す。
9.1.1.1.5 SetMutableBinding ( N, V, S )
-
もし envRec が N のバインディングを持たない場合、
- もし S が
true なら、ReferenceError 例外を投げる。 - ! envRec.CreateMutableBinding(N,
true ) を実行する。 - ! envRec.InitializeBinding(N, V) を実行する。
unused を返す。
- もし S が
- もし envRec の N のバインディングが strict バインディングなら、S を
true に設定する。 - もし envRec の N のバインディングが未初期化なら、
ReferenceError 例外を投げる。
- それ以外で、envRec の N のバインディングが可変バインディングなら、
- その値を V に変更する。
- それ以外、
アサート : これは不変バインディングの値を変更しようとしている。- もし S が
true なら、TypeError 例外を投げる。
unused を返す。
ステップ
function f() { eval("var x; x = (delete x, 0);"); }9.1.1.1.6 GetBindingValue ( N, S )
アサート : envRec は N のバインディングを持っている。- もし envRec の N のバインディングが未初期化なら
ReferenceError 例外を投げる。 - envRec の N に現在バインドされている値を返す。
9.1.1.1.7 DeleteBinding ( N )
アサート : envRec は N のバインディングを持っている。- もし envRec の N のバインディングが削除できない場合、
false を返す。 - envRec から N のバインディングを削除する。
true を返す。
9.1.1.1.8 HasThisBinding ( )
false を返す。
通常の this バインディングを提供しません。
9.1.1.1.9 HasSuperBinding ( )
false を返す。
通常の super バインディングを提供しません。
9.1.1.1.10 WithBaseObject ( )
undefined を返す。
9.1.1.2 オブジェクト環境レコード
各オブジェクト環境レコードは、自身のバインディングオブジェクトと呼ばれるオブジェクトに関連付けられています。オブジェクト環境レコードは、バインディングオブジェクトのプロパティ名と直接対応する文字列識別子名の集合をバインドします。
with文（
オブジェクト環境レコードは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[BindingObject]] | オブジェクト |
この |
| [[IsWithEnvironment]] | ブール値 |
このwith文のために作成されたかどうかを示す。
|
9.1.1.2.1 HasBinding ( N )
- bindingObjectをenvRec.[[BindingObject]]とする。
- foundBindingを ?
HasProperty (bindingObject, N)とする。 - foundBindingが
false なら、false を返す。 - envRec.[[IsWithEnvironment]]が
false なら、true を返す。 - unscopablesを ?
Get (bindingObject,%Symbol.unscopables% )とする。 - unscopablesが
オブジェクト の場合、 true を返す。
9.1.1.2.2 CreateMutableBinding ( N, D )
- bindingObjectをenvRec.[[BindingObject]]とする。
- ?
DefinePropertyOrThrow (bindingObject, N, PropertyDescriptor { [[Value]]:undefined , [[Writable]]:true , [[Enumerable]]:true , [[Configurable]]: D })を実行する。 unused を返す。
通常envRecはNのバインディングを持っていませんが、持っている場合は、
9.1.1.2.3 CreateImmutableBinding ( N, S )
9.1.1.2.4 InitializeBinding ( N, V )
- ? envRec.SetMutableBinding(N,
V,
false )を実行する。 unused を返す。
本仕様では、
9.1.1.2.5 SetMutableBinding ( N, V, S )
- bindingObjectをenvRec.[[BindingObject]]とする。
- stillExistsを ?
HasProperty (bindingObject, N)とする。 - stillExistsが
false かつSがtrue なら、ReferenceError 例外を投げる。 - ?
Set (bindingObject, N, V, S)を実行する。 unused を返す。
9.1.1.2.6 GetBindingValue ( N, S )
- bindingObjectをenvRec.[[BindingObject]]とする。
- valueを ?
HasProperty (bindingObject, N)とする。 - valueが
false の場合、- Sが
false ならundefined を返し、そうでなければReferenceError 例外を投げる。
- Sが
- ?
Get (bindingObject, N)を返す。
9.1.1.2.7 DeleteBinding ( N )
- bindingObjectをenvRec.[[BindingObject]]とする。
- ? bindingObject.[[Delete]](N)を返す。
9.1.1.2.8 HasThisBinding ( )
false を返す。
thisバインディングを提供しません。
9.1.1.2.9 HasSuperBinding ( )
false を返す。
superバインディングを提供しません。
9.1.1.2.10 WithBaseObject ( )
- envRec.[[IsWithEnvironment]]が
true なら、envRec.[[BindingObject]]を返す。 - それ以外の場合、
undefined を返す。
9.1.1.3 関数環境レコード
関数環境レコードは、関数のトップレベルスコープを表すために使われるthisバインディングを提供します。関数がsuperを参照する場合、その関数環境レコードは関数内からsuperメソッド呼び出しを行うための状態も保持します。
関数環境レコードは
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ThisValue]] |
|
この関数呼び出しで使われる |
| [[ThisBindingStatus]] |
|
値が |
| [[FunctionObject]] |
ECMAScript |
この |
| [[NewTarget]] |
|
この |
関数環境レコードは、
9.1.1.3.1 BindThisValue ( envRec, V )
抽象操作 BindThisValue は、引数 envRec（
アサート : envRec.[[ThisBindingStatus]]はlexical でないこと。- envRec.[[ThisBindingStatus]]が
initialized なら、ReferenceError 例外を投げる。 - envRec.[[ThisValue]]にVを設定する。
- envRec.[[ThisBindingStatus]]に
initialized を設定する。 unused を返す。
9.1.1.3.2 HasThisBinding ( )
- envRec.[[ThisBindingStatus]]が
lexical ならfalse を返し、それ以外ならtrue を返す。
9.1.1.3.3 HasSuperBinding ( )
- envRec.[[ThisBindingStatus]]が
lexical ならfalse を返す。 - envRec.[[FunctionObject]].[[HomeObject]]が
undefined ならfalse を返し、それ以外ならtrue を返す。
9.1.1.3.4 GetThisBinding ( )
アサート : envRec.[[ThisBindingStatus]]はlexical でないこと。- envRec.[[ThisBindingStatus]]が
uninitialized なら、ReferenceError 例外を投げる。 - envRec.[[ThisValue]]を返す。
9.1.1.3.5 GetSuperBase ( envRec )
抽象操作 GetSuperBase は、引数 envRec（superプロパティアクセスの基底となるオブジェクトを返す。値が
9.1.1.4 グローバル環境レコード
グローバル環境レコードは、共通の
グローバル環境レコードは論理的には単一のレコードですが、
グローバル環境レコードは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ObjectRecord]] |
|
バインディングオブジェクトは |
| [[GlobalThisValue]] | オブジェクト |
グローバルスコープにおけるthisの値。 |
| [[DeclarativeRecord]] |
|
|
| メソッド | 目的 |
|---|---|
| GetThisBinding() |
このthisバインディングの値を返す。
|
9.1.1.4.1 HasBinding ( N )
- DclRecをenvRec.[[DeclarativeRecord]]とする。
- ! DclRec.HasBinding(N)が
true なら、true を返す。 - ObjRecをenvRec.[[ObjectRecord]]とする。
- ? ObjRec.HasBinding(N)を返す。
9.1.1.4.2 CreateMutableBinding ( N, D )
- DclRecをenvRec.[[DeclarativeRecord]]とする。
- ! DclRec.HasBinding(N)が
true なら、TypeError 例外を投げる。 - ! DclRec.CreateMutableBinding(N, D)を返す。
9.1.1.4.3 CreateImmutableBinding ( N, S )
- DclRecをenvRec.[[DeclarativeRecord]]とする。
- ! DclRec.HasBinding(N)が
true なら、TypeError 例外を投げる。 - ! DclRec.CreateImmutableBinding(N, S)を返す。
9.1.1.4.4 InitializeBinding ( N, V )
- DclRecをenvRec.[[DeclarativeRecord]]とする。
- ! DclRec.HasBinding(N)が
true なら、- ! DclRec.InitializeBinding(N, V)を返す。
アサート ：バインディングが存在する場合、それはオブジェクト環境レコード に存在しなければならない。- ObjRecをenvRec.[[ObjectRecord]]とする。
- ? ObjRec.InitializeBinding(N, V)を返す。
9.1.1.4.5 SetMutableBinding ( N, V, S )
- DclRecをenvRec.[[DeclarativeRecord]]とする。
- ! DclRec.HasBinding(N)が
true なら、- ? DclRec.SetMutableBinding(N, V, S)を返す。
- ObjRecをenvRec.[[ObjectRecord]]とする。
- ? ObjRec.SetMutableBinding(N, V, S)を返す。
9.1.1.4.6 GetBindingValue ( N, S )
- DclRecをenvRec.[[DeclarativeRecord]]とする。
- ! DclRec.HasBinding(N)が
true なら、- ? DclRec.GetBindingValue(N, S)を返す。
- ObjRecをenvRec.[[ObjectRecord]]とする。
- ? ObjRec.GetBindingValue(N, S)を返す。
9.1.1.4.7 DeleteBinding ( N )
- DclRecをenvRec.[[DeclarativeRecord]]とする。
- ! DclRec.HasBinding(N)が
true なら、- ! DclRec.DeleteBinding(N)を返す。
- ObjRecをenvRec.[[ObjectRecord]]とする。
- globalObjectをObjRec.[[BindingObject]]とする。
- existingPropを?
HasOwnProperty (globalObject, N)とする。 - existingPropが
true なら、- ? ObjRec.DeleteBinding(N)を返す。
true を返す。
9.1.1.4.8 HasThisBinding ( )
true を返す。
thisバインディングを提供します。
9.1.1.4.9 HasSuperBinding ( )
false を返す。
superバインディングを提供しません。
9.1.1.4.10 WithBaseObject ( )
undefined を返す。
9.1.1.4.11 GetThisBinding ( )
- envRec.[[GlobalThisValue]]を返す。
9.1.1.4.12 HasLexicalDeclaration ( envRec, N )
抽象操作 HasLexicalDeclaration は、引数envRec（
- DclRecをenvRec.[[DeclarativeRecord]]とする。
- ! DclRec.HasBinding(N)を返す。
9.1.1.4.13 HasRestrictedGlobalProperty ( envRec, N )
抽象操作 HasRestrictedGlobalProperty は、引数envRec（
- ObjRecをenvRec.[[ObjectRecord]]とする。
- globalObjectをObjRec.[[BindingObject]]とする。
- existingPropを? globalObject.[[GetOwnProperty]](N)とする。
- existingPropが
undefined なら、false を返す。 - existingProp.[[Configurable]]が
true なら、false を返す。 true を返す。
9.1.1.4.14 CanDeclareGlobalVar ( envRec, N )
抽象操作 CanDeclareGlobalVar は、引数 envRec（
- ObjRecをenvRec.[[ObjectRecord]]とする。
- globalObjectをObjRec.[[BindingObject]]とする。
- hasPropertyを?
HasOwnProperty (globalObject, N)とする。 - hasPropertyが
true なら、true を返す。 - ?
IsExtensible (globalObject)を返す。
9.1.1.4.15 CanDeclareGlobalFunction ( envRec, N )
抽象操作 CanDeclareGlobalFunction は、引数 envRec（
- ObjRecをenvRec.[[ObjectRecord]]とする。
- globalObjectをObjRec.[[BindingObject]]とする。
- existingPropを? globalObject.[[GetOwnProperty]](N)とする。
- existingPropが
undefined なら、?IsExtensible (globalObject)を返す。 - existingProp.[[Configurable]]が
true なら、true を返す。 IsDataDescriptor (existingProp)がtrue かつexistingPropの属性値が{ [[Writable]]:true , [[Enumerable]]:true }であれば、true を返す。false を返す。
9.1.1.4.16 CreateGlobalVarBinding ( envRec, N, D )
抽象操作 CreateGlobalVarBinding は、引数 envRec（
- ObjRecをenvRec.[[ObjectRecord]]とする。
- globalObjectをObjRec.[[BindingObject]]とする。
- hasPropertyを?
HasOwnProperty (globalObject, N)とする。 - extensibleを?
IsExtensible (globalObject)とする。 - hasPropertyが
false かつextensibleがtrue なら、- ? ObjRec.CreateMutableBinding(N, D)を実行する。
- ? ObjRec.InitializeBinding(N,
undefined )を実行する。
unused を返す。
9.1.1.4.17 CreateGlobalFunctionBinding ( envRec, N, V, D )
抽象操作 CreateGlobalFunctionBinding は、引数 envRec（
- ObjRecをenvRec.[[ObjectRecord]]とする。
- globalObjectをObjRec.[[BindingObject]]とする。
- existingPropを? globalObject.[[GetOwnProperty]](N)とする。
- existingPropが
undefined またはexistingProp.[[Configurable]]がtrue なら、- descをPropertyDescriptor { [[Value]]:
V, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]: D }とする。
- descをPropertyDescriptor { [[Value]]:
V, [[Writable]]:
- それ以外の場合、
- descをPropertyDescriptor { [[Value]]: V }とする。
- ?
DefinePropertyOrThrow (globalObject, N, desc)を実行する。 - ?
Set (globalObject, N, V,false )を実行する。 unused を返す。
グローバル関数宣言は常に
9.1.1.5 モジュール環境レコード
モジュール環境レコードは、
モジュール環境レコードは、
| メソッド | 目的 |
|---|---|
| GetThisBinding() |
このthisバインディングの値を返す。
|
9.1.1.5.1 GetBindingValue ( N, S )
Sは常に
9.1.1.5.2 DeleteBinding ( N )
9.1.1.5.3 HasThisBinding ( )
true を返す。
thisバインディングを提供します。
9.1.1.5.4 GetThisBinding ( )
undefined を返す。
9.1.1.5.5 CreateImportBinding ( envRec, N, M, N2 )
抽象操作 CreateImportBinding は、引数 envRec（
9.1.2 環境レコードの操作
以下の
9.1.2.1 GetIdentifierReference ( env, name, strict )
抽象操作 GetIdentifierReference は、引数 env（
- envが
null なら、Reference Record { [[Base]]:unresolvable , [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty } を返す。
- exists を ? env.HasBinding(name) とする。
- existsが
true なら、Reference Record { [[Base]]: env, [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty } を返す。
- それ以外の場合、
- outer を env.[[OuterEnv]] とする。
- ?
GetIdentifierReference (outer, name, strict) を返す。
9.1.2.2 NewDeclarativeEnvironment ( E )
抽象操作 NewDeclarativeEnvironment は、引数 E（
- env をバインディングが何もない新しい
宣言的環境レコード とする。 - env.[[OuterEnv]] に E を設定する。
- env を返す。
9.1.2.3 NewObjectEnvironment ( O, W, E )
抽象操作 NewObjectEnvironment は、引数 O（オブジェクト）、W（ブール値）、E（
- env を新しい
オブジェクト環境レコード とする。 - env.[[BindingObject]] に O を設定する。
- env.[[IsWithEnvironment]] に W を設定する。
- env.[[OuterEnv]] に E を設定する。
- env を返す。
9.1.2.4 NewFunctionEnvironment ( F, newTarget )
抽象操作 NewFunctionEnvironment は、引数 F（ECMAScript
- env をバインディングが何もない新しい
関数環境レコード とする。 - env.[[FunctionObject]] に F を設定する。
- F.[[ThisMode]] が
lexical なら、env.[[ThisBindingStatus]] にlexical を設定する。 - それ以外の場合、env.[[ThisBindingStatus]] に
uninitialized を設定する。 - env.[[NewTarget]] に newTarget を設定する。
- env.[[OuterEnv]] に F.[[Environment]] を設定する。
- env を返す。
9.1.2.5 NewGlobalEnvironment ( G, thisValue )
抽象操作 NewGlobalEnvironment は、引数 G（オブジェクト）、thisValue（オブジェクト）を取り、
- objRec を
NewObjectEnvironment (G,false ,null ) とする。 - dclRec を
NewDeclarativeEnvironment (null ) とする。 - env を新しい
グローバル環境レコード とする。 - env.[[ObjectRecord]] に objRec を設定する。
- env.[[GlobalThisValue]] に thisValue を設定する。
- env.[[DeclarativeRecord]] に dclRec を設定する。
- env.[[OuterEnv]] に
null を設定する。 - env を返す。
9.1.2.6 NewModuleEnvironment ( E )
抽象操作 NewModuleEnvironment は、引数 E（
- env をバインディングが何もない新しい
モジュール環境レコード とする。 - env.[[OuterEnv]] に E を設定する。
- env を返す。
9.2 プライベート環境レコード
プライベート環境レコードは、ECMAScriptコード内の
各
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[OuterPrivateEnvironment]] |
|
最も近い外側のクラスの |
| [[Names]] |
|
このクラスによって宣言された |
9.2.1 プライベート環境レコードの操作
以下の
9.2.1.1 NewPrivateEnvironment ( outerPrivateEnv )
抽象操作 NewPrivateEnvironment は、引数 outerPrivateEnv（
- names を新しい空の
リスト とする。 -
プライベート環境レコード { [[OuterPrivateEnvironment]]: outerPrivateEnv, [[Names]]: names } を返す。
9.2.1.2 ResolvePrivateIdentifier ( privateEnv, identifier )
抽象操作 ResolvePrivateIdentifier は、引数 privateEnv（
- names を privateEnv.[[Names]] とする。
-
names の各
プライベート名 pnについて、- pn.[[Description]] が
identifier であれば、
- pn を返す。
- pn.[[Description]] が
identifier であれば、
- outerPrivateEnv を privateEnv.[[OuterPrivateEnvironment]] とする。
アサート ：outerPrivateEnvはnull ではない。-
ResolvePrivateIdentifier (outerPrivateEnv, identifier) を返す。
9.3 レルム
評価される前に、すべてのECMAScriptコードはレルムに関連付けられていなければなりません。概念的には、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[AgentSignifier]] |
|
この |
| [[Intrinsics]] |
|
この |
| [[GlobalObject]] | オブジェクト |
この |
| [[GlobalEnv]] |
|
この |
| [[TemplateMap]] |
|
テンプレートオブジェクトは各 ある
|
| [[LoadedModules]] |
|
この import()式が |
| [[HostDefined]] |
任意（デフォルト値は |
|
9.3.1 InitializeHostDefinedRealm ( )
抽象操作 InitializeHostDefinedRealm は引数を取らず、
- realm を新しい
レルムレコード とする。 CreateIntrinsics (realm)を実行する。- realm.[[AgentSignifier]]に
AgentSignifier ()の値を設定する。 - realm.[[TemplateMap]]に新しい空の
リスト を設定する。 - newContext を新しい
実行コンテキスト とする。 - newContextのFunctionを
null に設定する。 - newContextの
レルム をrealmに設定する。 - newContextのScriptOrModuleを
null に設定する。 - newContextを
実行コンテキストスタック にプッシュする。newContextが実行中の実行コンテキスト となる。 ホスト がエキゾチックオブジェクト をrealmのグローバルオブジェクト として必要とする場合、- globalをそのようなオブジェクトとして
ホスト定義 の方法で作成する。
- globalをそのようなオブジェクトとして
- それ以外の場合、
- globalを
OrdinaryObjectCreate (realm.[[Intrinsics]].[[%Object.prototype% ]])とする。
- globalを
ホスト がrealmのグローバルスコープのthisバインディングをグローバルオブジェクト 以外のオブジェクトにする必要がある場合、- thisValueをそのようなオブジェクトとして
ホスト定義 の方法で作成する。
- thisValueをそのようなオブジェクトとして
- それ以外の場合、
- thisValueをglobalとする。
- realm.[[GlobalObject]]にglobalを設定する。
- realm.[[GlobalEnv]]に
NewGlobalEnvironment (global, thisValue)を設定する。 - ?
SetDefaultGlobalBindings (realm)を実行する。 ホスト定義 のグローバルオブジェクト プロパティをglobalに作成する。unused を返す。
9.3.2 CreateIntrinsics ( realmRec )
抽象操作 CreateIntrinsics は、引数 realmRec（
- realmRec.[[Intrinsics]] に新しい
レコード を設定する。 - realmRec.[[Intrinsics]]のフィールドに、
表6 に記載の値を設定する。フィールド名は表の第1列。値は、この仕様の19 から28 各オブジェクトの仕様に従って完全かつ再帰的にプロパティ値が設定された新しいオブジェクト値。すべてのオブジェクトプロパティ値は新しいオブジェクト値。組み込み関数オブジェクト はCreateBuiltinFunction (steps, length, name, slots, realmRec, prototype) で作成される。stepsはこの仕様で定義された関数、nameは関数の"name" プロパティの初期値、lengthは"length" プロパティの初期値、slotsは内部スロット名リスト、prototypeは[[Prototype]]内部スロットの指定値。組み込みとそのプロパティの作成順序は、未作成のオブジェクトへの依存が発生しないようにしなければならない。 AddRestrictedFunctionProperties (realmRec.[[Intrinsics]].[[%Function.prototype% ]], realmRec)を実行する。unused を返す。
9.3.3 SetDefaultGlobalBindings ( realmRec )
抽象操作 SetDefaultGlobalBindings は、引数 realmRec（
- globalをrealmRec.[[GlobalObject]]とする。
19 で指定されるグローバルオブジェクトの各プロパティについて、- nameを
プロパティ名 の文字列値とする。 - descを、そのプロパティの指定属性を含む完全なデータ
プロパティディスクリプタ とする。19.2 、19.3 、19.4 に列挙されるプロパティの場合、[[Value]]属性の値はrealmRecの対応する組み込みオブジェクト。 - ?
DefinePropertyOrThrow (global, name, desc)を実行する。
- nameを
unused を返す。
9.4 実行コンテキスト
実行コンテキストは、ECMAScriptの実装によるコードの実行時評価を追跡するために使用される仕様デバイスです。任意の時点で、実際にコードを実行している
実行コンテキストスタックは、実行コンテキストを追跡するために使用されます。
実行コンテキストは、それに関連付けられたコードの実行進捗を追跡するために必要な実装依存の状態を含みます。各実行コンテキストは、少なくとも
| コンポーネント | 目的 |
|---|---|
| code evaluation state |
この |
| Function |
もしこの |
|
|
関連コードがECMAScriptリソースへアクセスするために利用する |
| ScriptOrModule |
関連コードが由来する |
ECMAScriptコード実行コンテキストは、
| コンポーネント | 目的 |
|---|---|
| LexicalEnvironment |
この |
| VariableEnvironment |
この |
| PrivateEnvironment |
直近の包含クラス内で |
実行コンテキストのLexicalEnvironmentおよびVariableEnvironmentコンポーネントは常に
ジェネレーターの評価を表す実行コンテキストは、
| コンポーネント | 目的 |
|---|---|
| Generator |
この |
ほとんどの場合、仕様内のアルゴリズムによって直接操作されるのは
実行コンテキストは純粋に仕様上の仕組みであり、ECMAScript実装の特定の構造体に対応している必要はありません。ECMAScriptコードから直接実行コンテキストにアクセスしたり観察したりすることはできません。
9.4.1 GetActiveScriptOrModule ( )
抽象操作GetActiveScriptOrModuleは引数を取らず、
- もし
実行コンテキストスタック が空であれば、null を返す。 - ecを、
実行コンテキストスタック 上のScriptOrModuleコンポーネントがnull でない最上位の実行コンテキスト とする。 - そのような
実行コンテキスト が存在しない場合、null を返す。そうでなければ、ecのScriptOrModuleを返す。
9.4.2 ResolveBinding ( name [ , env ] )
抽象操作ResolveBindingは、引数name（文字列）および省略可能な引数env（
- もしenvが指定されていない、またはenvが
undefined の場合、- envに
実行中の実行コンテキスト のLexicalEnvironmentを設定する。
- envに
保証 ：envはEnvironment Record である。- strictを
IsStrict (評価中の構文生成規則)とする。 - 戻り値は?
GetIdentifierReference (env, name, strict)とする。
ResolveBindingの結果は常に、その[[ReferencedName]]フィールドがnameとなる
9.4.3 GetThisEnvironment ( )
抽象操作GetThisEnvironmentは引数を取らず、thisのバインディングを提供する
- envを
実行中の実行コンテキスト のLexicalEnvironmentとする。 - 繰り返す。
- existsをenv.HasThisBinding()とする。
- もしexistsが
true なら、envを返す。 - outerをenv.[[OuterEnv]]とする。
保証 ：outerはnull でない。- envにouterを設定する。
ステップthisバインディングを持つグローバル環境で終わるからです。
9.4.4 ResolveThisBinding ( )
抽象操作ResolveThisBindingは引数を取らず、thisのバインディングを決定します。呼び出し時、次の手順を実行します:
- envRecを
GetThisEnvironment ()とする。 - 戻り値は? envRec.GetThisBinding()とする。
9.4.5 GetNewTarget ( )
抽象操作GetNewTargetは引数を取らず、オブジェクトまたは
- envRecを
GetThisEnvironment ()とする。 保証 ：envRecは[[NewTarget]]フィールドを持つ。- 戻り値はenvRec.[[NewTarget]]とする。
9.4.6 GetGlobalObject ( )
抽象操作GetGlobalObjectは引数を取らず、オブジェクトを返します。これは、現在の
- currentRealmを
現在のRealm Record とする。 - 戻り値はcurrentRealm.[[GlobalObject]]とする。
9.5 ジョブおよびジョブをキューに入れるためのホスト操作
ジョブとは、パラメータを持たず、他のECMAScript計算が現在進行中でないときにECMAScript計算を開始する
- ジョブがスケジュールされた
エージェント において、実行中のコンテキストがなく、そのエージェント の実行コンテキストスタック が空である将来のある時点で、実装は以下を行う必要があります:- 任意の
ホスト定義 の準備ステップを実行する。 呼び出す ジョブ となる抽象クロージャ 。- 任意の
ホスト定義 のクリーンアップステップを実行し、その後実行コンテキストスタック が空であることを保証する。
- 任意の
- 任意の時点で、1つの
エージェント 内で同時に評価中のジョブ は1つだけでなければなりません。 - 一度ある
ジョブ の評価が開始されたら、その評価は同じエージェント 内で他のジョブ の評価が始まる前に完了しなければなりません。 抽象クロージャ はnormal completion を返さなければならず、エラーの処理は自ら実装しなければなりません。
ある時点で、すべての次の条件が真であれば、scriptOrModule（
GetActiveScriptOrModule ()がscriptOrModuleである。- もしscriptOrModuleが
Script Record またはModule Record なら、ecを実行コンテキストスタック 上でScriptOrModuleコンポーネントがscriptOrModuleである最上位の実行コンテキスト とし、ecのRealm コンポーネントはscriptOrModule.[[Realm]]である。
ある時点で、すべての次の条件が真であれば、実行はECMAScriptコードを評価する準備ができている状態です:
実行コンテキストスタック が空でない。実行コンテキストスタック 上の最上位の実行コンテキスト のRealm コンポーネントがRealm Record である。
特定の種類の
9.5.1 JobCallbackレコード
JobCallbackレコードは、
WHATWG HTML仕様（https://html.spec.whatwg.org/）は、例えばPromiseコールバックのためにインカンバント設定オブジェクトを伝播するために
JobCallbackレコードは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Callback]] |
|
|
| [[HostDefined]] |
任意の値（デフォルト値は |
|
9.5.2 HostMakeJobCallback ( callback )
HostMakeJobCallbackの実装は、以下の要件を満たさなければなりません：
- [[Callback]]フィールドがcallbackである
JobCallbackレコード を返さなければなりません。
HostMakeJobCallbackのデフォルト実装は、呼び出し時に次の手順を実行します：
JobCallbackレコード { [[Callback]]: callback, [[HostDefined]]:empty }を返す。
WebブラウザでないECMAScript
これは、コールバックが最終的にスケジュールされ実行される責任を持つ関数に渡された時点で呼び出されます。たとえば、promise.then(thenAction)はPromise.prototype.thenの呼び出し時にthenActionに対してMakeJobCallbackを呼び出しますが、リアクション
9.5.3 HostCallJobCallback ( jobCallback, V, argumentsList )
HostCallJobCallbackの実装は、以下の要件を満たさなければなりません：
Call (jobCallback.[[Callback]], V, argumentsList)を実行し、その結果を返さなければなりません。
HostCallJobCallbackのデフォルト実装は、呼び出し時に次の手順を実行します：
保証 :IsCallable (jobCallback.[[Callback]])はtrue である。- ?
Call (jobCallback.[[Callback]], V, argumentsList)を返す。
WebブラウザでないECMAScript
9.5.4 HostEnqueueGenericJob ( job, realm )
HostEnqueueGenericJobの実装は、
9.5.5 HostEnqueuePromiseJob ( job, realm )
HostEnqueuePromiseJobの実装は、
- もしrealmが
null でない場合、jobが呼び出されるたびに、実装はその呼び出し時に実行がECMAScriptコードを評価する準備ができている 状態であることを保証する実装依存 のステップを実行しなければなりません。 - HostEnqueuePromiseJobが呼び出された時点で
GetActiveScriptOrModule ()の値をscriptOrModuleとする。もしrealmがnull でない場合、毎回jobが呼び出されるたびに、実装はscriptOrModuleがその呼び出し時にアクティブなスクリプトまたはモジュール であることを保証する実装依存 のステップを実行しなければなりません。 ジョブ は、それらをスケジュールしたHostEnqueuePromiseJob呼び出しの順番と同じ順序で実行されなければなりません。
9.5.6 HostEnqueueTimeoutJob ( timeoutJob, realm, milliseconds )
HostEnqueueTimeoutJobの実装は、
9.6 エージェント
エージェントは、一連のECMAScript
例えば、一部のウェブブラウザーは、複数の無関係なタブ間で一つの
エージェント識別子は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[LittleEndian]] | Boolean | |
| [[CanBlock]] | Boolean | |
| [[Signifier]] | 自身の |
|
| [[IsLockFree1]] | Boolean | 1 |
| [[IsLockFree2]] | Boolean | 2 |
| [[IsLockFree8]] | Boolean | 8 |
| [[CandidateExecution]] | ||
| [[KeptAlive]] | 新たな空 |
|
| [[ModuleAsyncEvaluationCount]] | 初期値0。非同期もしくは非同期依存を持つモジュールの[[AsyncEvaluationOrder]]フィールドに一意な増加値を割り当てるために使用。 |
[[Signifier]]、[[IsLockFree1]]、[[IsLockFree2]]の値は、一度
[[IsLockFree1]]および[[IsLockFree2]]の値は、必ずしもハードウェアによって決まるものではなく、実装ごと・時間ごとに異なる実装選択を反映することがあります。
[[IsLockFree4]]フィールドは存在しません。4バイトのアトミック操作は常にロックフリーです。
実際には、アトミック操作が何らかのロックを伴って実装されている場合、その操作はロックフリーではありません。ロックフリーはウェイトフリーを意味せず、ロックフリーなアトミック操作を完了するのに必要なマシンステップ数に上限はありません。
サイズnのアトミックアクセスがロックフリーであることは、サイズnの非アトミックアクセスの（見かけ上の）アトミシティについては何も意味しません。具体的には、非アトミックアクセスは複数の個別なメモリアクセスの連続として実行されることがあります。詳細は
9.6.1 AgentSignifier ( )
抽象操作AgentSignifierは引数を取らず、
- ARを
周囲のエージェント のエージェントレコード とする。 - AR.[[Signifier]]を返す。
9.6.2 AgentCanSuspend ( )
抽象操作AgentCanSuspendは引数を取らず、Booleanを返します。呼び出し時、次の手順を実行します：
- ARを
周囲のエージェント のエージェントレコード とする。 - AR.[[CanBlock]]を返す。
環境によっては、特定の
9.6.3 IncrementModuleAsyncEvaluationCount ( )
抽象操作IncrementModuleAsyncEvaluationCountは引数を取らず、
- ARを
周囲のエージェント のエージェントレコード とする。 - countをAR.[[ModuleAsyncEvaluationCount]]とする。
- AR.[[ModuleAsyncEvaluationCount]]にcount+1を設定する。
- countを返す。
この値は未処理モジュール間の相対評価順序を追跡するためだけに使用されます。未処理モジュールが存在しない場合、実装は[[ModuleAsyncEvaluationCount]]を密かに0にリセットしてもかまいません。
9.7 エージェントクラスタ
エージェントクラスタは、共有メモリ上で操作することで通信できる
すべての
クラスタ内のすべての
同一エージェントクラスタ内で異なる
クラスタ内のすべての
クラスタ内のすべての
埋め込み環境は、
この制約は、他の
この制約の帰結として、埋め込み環境内で同じサスペンド／ウェイク集団に属さない
埋め込み環境は、クラスタ内の他の
以下の仕様値およびそれらから伝播的に到達可能な値は、正確に1つのエージェントクラスタに属します。
クラスタ内のいずれかの
同じエージェントクラスタ内のすべての
エージェントクラスタは仕様上の仕組みであり、ECMAScript実装の特定の構造物に対応している必要はありません。
9.8 フォワードプログレス
実装は以下を保証しなければなりません：
- 専用の
実行スレッド を持つ、すべてのアンブロックされたエージェント が最終的にフォワードプログレスを行うこと 実行スレッド を共有するエージェント の集合において、いずれか1つのエージェント が最終的にフォワードプログレスを行うこと- ある
エージェント が、ブロッキングを提供する明示的なAPI以外の手段で他のエージェント をブロック状態にしないこと
9.9 WeakRefおよびFinalizationRegistryターゲットの処理モデル
9.9.1 目標
本仕様は、いかなるオブジェクトやシンボルもガベージコレクションされることを保証しません。
-
WeakRef.prototype.derefが呼ばれたとき、（undefined が返されない場合）参照先は生存し続け、以降の同期的なアクセスでも同じ値が返されます。このリストは、同期的な作業がClearKeptObjects 抽象操作によって終了したときにリセットされます。 -
FinalizationRegistry に登録されたオブジェクトやシンボルが到達不能になった場合、同期的なECMAScript実行が完了した後、FinalizationRegistry のクリーンアップコールバックの呼び出しが最終的に行われることがあります。クリーンアップはCleanupFinalizationRegistry 抽象操作で実行されます。
これらのアクション（
一部のECMAScript実装には、ECMAScriptがアイドル状態のときも含めてバックグラウンドで動作するガベージコレクタの実装が含まれています。
9.9.2 ライブネス
あるオブジェクトやシンボルの集合Sについて、仮想的なWeakRef非考慮実行とは、Sの要素を参照する
評価中の任意の時点で、オブジェクトやシンボルの集合Sは、次のいずれかの条件を満たす場合にライブと見なされます：
フィールド、内部スロット、またはプロパティにオブジェクトやシンボルが存在することは、その値がライブであることを意味しません。たとえば、その値がプログラムに返されない場合は観測できません。
これはWeakMapのキーやWeakSetのメンバー、
上記定義は、WeakMapのキーがライブでない場合、その対応する値も必ずしもライブでないことを意味します。
9.9.3 実行
任意の時点で、オブジェクトやシンボルの集合Sが
- Sの各要素valueについて、次を行う
- ref.[[WeakRefTarget]]がvalueである
WeakRef refそれぞれについて、次を行う- ref.[[WeakRefTarget]]を
empty に設定する。
- ref.[[WeakRefTarget]]を
- fg.[[Cells]]に、cell.[[WeakRefTarget]]がvalueである
Record cellを含むFinalizationRegistry fgそれぞれについて、次を行う- cell.[[WeakRefTarget]]を
empty に設定する。 - 必要に応じて
HostEnqueueFinalizationRegistryCleanupJob (fg)を実行する。
- cell.[[WeakRefTarget]]を
- map.[[WeakMapData]]に、r.[[Key]]がvalueである
Record rを含むWeakMap mapそれぞれについて、次を行う- r.[[Key]]を
empty に設定する。 - r.[[Value]]を
empty に設定する。
- r.[[Key]]を
- set.[[WeakSetData]]にvalueを含むWeakSet
setそれぞれについて、次を行う
- set.[[WeakSetData]]内の値がvalueである要素を、値が
empty である要素に置き換える。
- set.[[WeakSetData]]内の値がvalueである要素を、値が
- ref.[[WeakRefTarget]]がvalueである
ライブネスの定義と合わせて、この節は
オブジェクトの識別性を観測せずにアクセスすることは可能です。逃避しないオブジェクトのプロパティへのスカラ置換やデッドバリアブル除去など、識別性が観測されない場合の最適化は許されます。従って、そのようなオブジェクトを指す
一方、オブジェクトの識別性が観測され、そのオブジェクトが
9.9.4 ホストフック
9.9.4.1 HostEnqueueFinalizationRegistryCleanupJob ( finalizationRegistry )
cleanupJobを、引数を取らずfinalizationRegistryをキャプチャし、呼び出されたときに次の手順を実行する新たな
- cleanupResultを
Completion (CleanupFinalizationRegistry (finalizationRegistry))とする。 - もしcleanupResultが
abrupt completion であれば、エラー報告のためのホスト定義 の手順を実行する。 unused を返す。
HostEnqueueFinalizationRegistryCleanupJobの実装は、可能であればcleanupJobを将来のある時点で実行されるようスケジューリングします。また、
9.10 ClearKeptObjects ( )
抽象操作ClearKeptObjectsは引数を取らず、
- agentRecordを
周囲のエージェント のエージェントレコード とする。 - agentRecord.[[KeptAlive]]を新たな空の
List に設定する。 unused を返す。
9.11 AddToKeptObjects ( value )
抽象操作AddToKeptObjectsは引数value（オブジェクトまたはシンボル）を取り、
- agentRecordを
周囲のエージェント のエージェントレコード とする。 - valueをagentRecord.[[KeptAlive]]に追加する。
unused を返す。
9.12 CleanupFinalizationRegistry ( finalizationRegistry )
抽象操作CleanupFinalizationRegistryは引数finalizationRegistry（
保証 ：finalizationRegistryは[[Cells]]および[[CleanupCallback]]内部スロットを持つ。- callbackをfinalizationRegistry.[[CleanupCallback]]とする。
- finalizationRegistry.[[Cells]]に、cell.[[WeakRefTarget]]が
empty であるRecord cellが含まれている間、実装は次の手順を実行してもよい：- そのようなcellを任意に選択する。
- cellをfinalizationRegistry.[[Cells]]から削除する。
- ?
HostCallJobCallback (callback,undefined , « cell.[[HeldValue]] » ) を実行する。
unused を返す。
9.13 CanBeHeldWeakly ( v )
抽象操作CanBeHeldWeaklyは引数v（
- もしvが
オブジェクトである なら、true を返す。 - もしvが
シンボルである かつKeyForSymbol (v)がundefined であるなら、true を返す。 false を返す。
10 通常オブジェクトおよびエキゾチックオブジェクトの挙動
10.1 通常オブジェクトの内部メソッドと内部スロット
すべての
すべての
以下のアルゴリズム記述では、Oは
各
10.1.1 [[GetPrototypeOf]] ( )
OrdinaryGetPrototypeOf (O)を返す。
10.1.1.1 OrdinaryGetPrototypeOf ( O )
抽象操作OrdinaryGetPrototypeOfは引数O（オブジェクト）を取り、オブジェクトまたは
- O.[[Prototype]]を返す。
10.1.2 [[SetPrototypeOf]] ( V )
OrdinarySetPrototypeOf (O, V)を返す。
10.1.2.1 OrdinarySetPrototypeOf ( O, V )
抽象操作OrdinarySetPrototypeOfは引数O（オブジェクト）、V（オブジェクトまたは
- currentをO.[[Prototype]]とする。
SameValue (V, current)がtrue なら、true を返す。- extensibleをO.[[Extensible]]とする。
- extensibleが
false なら、false を返す。 - pをVとする。
- doneを
false とする。 -
繰り返し、doneが
false の間、 - O.[[Prototype]]にVを設定する。
true を返す。
10.1.3 [[IsExtensible]] ( )
OrdinaryIsExtensible (O)を返す。
10.1.3.1 OrdinaryIsExtensible ( O )
抽象操作OrdinaryIsExtensibleは引数O（オブジェクト）を取り、Booleanを返します。呼び出されたとき、次の手順を実行します：
- O.[[Extensible]]を返す。
10.1.4 [[PreventExtensions]] ( )
OrdinaryPreventExtensions (O)を返す。
10.1.4.1 OrdinaryPreventExtensions ( O )
抽象操作OrdinaryPreventExtensionsは引数O（オブジェクト）を取り、
- O.[[Extensible]]に
false を設定する。 true を返す。
10.1.5 [[GetOwnProperty]] ( P )
OrdinaryGetOwnProperty (O, P)を返す。
10.1.5.1 OrdinaryGetOwnProperty ( O, P )
抽象操作OrdinaryGetOwnPropertyは引数O（オブジェクト）、P（
- OがキーPの独自プロパティを持たない場合、
undefined を返す。 - Dを新たなフィールドを持たない
プロパティディスクリプタ として作成する。 - XをキーPを持つOの独自プロパティとする。
- Xが
データプロパティ であれば、- D.[[Value]]にXの[[Value]]属性の値を設定する。
- D.[[Writable]]にXの[[Writable]]属性の値を設定する。
- そうでなければ、
- D.[[Enumerable]]にXの[[Enumerable]]属性の値を設定する。
- D.[[Configurable]]にXの[[Configurable]]属性の値を設定する。
- Dを返す。
10.1.6 [[DefineOwnProperty]] ( P, Desc )
- ?
OrdinaryDefineOwnProperty (O, P, Desc)を返す。
10.1.6.1 OrdinaryDefineOwnProperty ( O, P, Desc )
抽象操作OrdinaryDefineOwnPropertyは引数O（オブジェクト）、P（
- currentを? O.[[GetOwnProperty]](P)とする。
- extensibleを?
IsExtensible (O)とする。 ValidateAndApplyPropertyDescriptor (O, P, extensible, Desc, current)を返す。
10.1.6.2 IsCompatiblePropertyDescriptor ( Extensible, Desc, Current )
抽象操作IsCompatiblePropertyDescriptorは引数Extensible（Boolean）、Desc（
ValidateAndApplyPropertyDescriptor (undefined ,"" , Extensible, Desc, Current)を返す。
10.1.6.3 ValidateAndApplyPropertyDescriptor ( O, P, extensible, Desc, current )
抽象操作ValidateAndApplyPropertyDescriptorは、引数O（オブジェクトまたは
保証 ：Pはプロパティキー である。- もしcurrentが
undefined なら、- もしextensibleが
false なら、false を返す。 - もしOが
undefined なら、true を返す。 - もし
IsAccessorDescriptor (Desc)がtrue なら、 - それ以外の場合、
true を返す。
- もしextensibleが
保証 ：currentは全てのフィールドが埋められたプロパティディスクリプタ である。- もしDescがいかなるフィールドも持たないなら、
true を返す。 - もしcurrent.[[Configurable]]が
false なら、- もしDescが[[Configurable]]フィールドを持ち、かつDesc.[[Configurable]]が
true なら、false を返す。 - もしDescが[[Enumerable]]フィールドを持ち、かつDesc.[[Enumerable]]がcurrent.[[Enumerable]]と異なるなら、
false を返す。 - もし
IsGenericDescriptor (Desc)がfalse かつIsAccessorDescriptor (Desc)がIsAccessorDescriptor (current)と異なるなら、false を返す。 - もし
IsAccessorDescriptor (current)がtrue なら、 - それ以外の場合、もしcurrent.[[Writable]]が
false なら、
- もしDescが[[Configurable]]フィールドを持ち、かつDesc.[[Configurable]]が
- もしOが
undefined でないなら、- もし
IsDataDescriptor (current)がtrue かつIsAccessorDescriptor (Desc)がtrue なら、- もしDescが[[Configurable]]フィールドを持つならconfigurableをDesc.[[Configurable]]とし、なければcurrent.[[Configurable]]とする。
- もしDescが[[Enumerable]]フィールドを持つならenumerableをDesc.[[Enumerable]]とし、なければcurrent.[[Enumerable]]とする。
- オブジェクトOのPという名前のプロパティを、[[Configurable]]属性および[[Enumerable]]属性をそれぞれconfigurableおよびenumerableに、[[Get]]および[[Set]]属性をDescにそのフィールドがあればその値、なければ属性の
デフォルト値 に設定したアクセサプロパティ で置き換える。
- それ以外で、
IsAccessorDescriptor (current)がtrue かつIsDataDescriptor (Desc)がtrue なら、- もしDescが[[Configurable]]フィールドを持つならconfigurableをDesc.[[Configurable]]とし、なければcurrent.[[Configurable]]とする。
- もしDescが[[Enumerable]]フィールドを持つならenumerableをDesc.[[Enumerable]]とし、なければcurrent.[[Enumerable]]とする。
- オブジェクトOのPという名前のプロパティを、[[Configurable]]属性および[[Enumerable]]属性をそれぞれconfigurableおよびenumerableに、[[Value]]および[[Writable]]属性をDescにそのフィールドがあればその値、なければ属性の
デフォルト値 に設定したデータプロパティ で置き換える。
- それ以外の場合、
- Descの各フィールドについて、オブジェクトOのPという名前のプロパティの対応する属性にその値を設定する。
- もし
true を返す。
10.1.7 [[HasProperty]] ( P )
- Return ?
OrdinaryHasProperty (O, P).
10.1.7.1 OrdinaryHasProperty ( O, P )
抽象操作 OrdinaryHasProperty は、引数 O（オブジェクト）と P（
- hasOwn を ? O.[[GetOwnProperty]](P) とする。
- もし hasOwn が
undefined でなければ、true を返す。 - parent を ? O.[[GetPrototypeOf]]() とする。
- もし parent が
null でなければ、- Return ? parent.[[HasProperty]](P)。
false を返す。
10.1.8 [[Get]] ( P, Receiver )
- Return ?
OrdinaryGet (O, P, Receiver).
10.1.8.1 OrdinaryGet ( O, P, Receiver )
抽象操作 OrdinaryGet は、引数 O（オブジェクト）、P（
- desc を ? O.[[GetOwnProperty]](P) とする。
- もし desc が
undefined なら、- parent を ? O.[[GetPrototypeOf]]() とする。
- もし parent が
null なら、undefined を返す。 - Return ? parent.[[Get]](P, Receiver)。
- もし
IsDataDescriptor (desc) がtrue なら、desc.[[Value]] を返す。 保証 ：IsAccessorDescriptor (desc) がtrue である。- getter を desc.[[Get]] とする。
- もし getter が
undefined なら、undefined を返す。 - Return ?
Call (getter, Receiver)。
10.1.9 [[Set]] ( P, V, Receiver )
- Return ?
OrdinarySet (O, P, V, Receiver).
10.1.9.1 OrdinarySet ( O, P, V, Receiver )
抽象操作 OrdinarySet は、引数 O（オブジェクト）、P（
- ownDesc を ? O.[[GetOwnProperty]](P) とする。
- Return ?
OrdinarySetWithOwnDescriptor (O, P, V, Receiver, ownDesc)。
10.1.9.2 OrdinarySetWithOwnDescriptor ( O, P, V, Receiver, ownDesc )
抽象操作 OrdinarySetWithOwnDescriptor は、引数 O（オブジェクト）、P（
- もし ownDesc が
undefined なら、- parent を ? O.[[GetPrototypeOf]]() とする。
- もし parent が
null でなければ、- Return ? parent.[[Set]](P, V, Receiver)。
- それ以外の場合、
- ownDesc を PropertyDescriptor { [[Value]]:
undefined , [[Writable]]:true , [[Enumerable]]:true , [[Configurable]]:true } とする。
- ownDesc を PropertyDescriptor { [[Value]]:
- もし
IsDataDescriptor (ownDesc) がtrue なら、- もし ownDesc.[[Writable]] が
false なら、false を返す。 - もし Receiver
がオブジェクトでない なら、false を返す。 - existingDescriptor を ? Receiver.[[GetOwnProperty]](P) とする。
- もし existingDescriptor が
undefined でなければ、- もし
IsAccessorDescriptor (existingDescriptor) がtrue なら、false を返す。 - もし existingDescriptor.[[Writable]] が
false なら、false を返す。 - valueDesc を PropertyDescriptor { [[Value]]: V } とする。
- Return ? Receiver.[[DefineOwnProperty]](P, valueDesc)。
- もし
- それ以外の場合、
保証 ：Receiverは現在プロパティPを持たない。- Return ?
CreateDataProperty (Receiver, P, V)。
- もし ownDesc.[[Writable]] が
保証 ：IsAccessorDescriptor (ownDesc) がtrue である。- setter を ownDesc.[[Set]] とする。
- もし setter が
undefined なら、false を返す。 - ?
Call (setter, Receiver, « V ») を実行する。 true を返す。
10.1.10 [[Delete]] ( P )
- Return ?
OrdinaryDelete (O, P).
10.1.10.1 OrdinaryDelete ( O, P )
抽象操作 OrdinaryDelete は、引数 O（オブジェクト）、P（
- desc を ? O.[[GetOwnProperty]](P) とする。
- もし desc が
undefined なら、true を返す。 - もし desc.[[Configurable]] が
true なら、- O から名前 P の独自プロパティを削除する。
true を返す。
false を返す。
10.1.11 [[OwnPropertyKeys]] ( )
- Return
OrdinaryOwnPropertyKeys (O).
10.1.11.1 OrdinaryOwnPropertyKeys ( O )
抽象操作 OrdinaryOwnPropertyKeys は、引数 O（オブジェクト）を取り、
10.1.12 OrdinaryObjectCreate ( proto [ , additionalInternalSlotsList ] )
抽象操作 OrdinaryObjectCreate は、引数 proto（オブジェクトまたは
- internalSlotsList を « [[Prototype]], [[Extensible]] » とする。
- もし additionalInternalSlotsList が存在するなら、internalSlotsList を
リスト結合 により internalSlotsList と additionalInternalSlotsList の連結結果に設定する。 - O を
MakeBasicObject (internalSlotsList) とする。 - O.[[Prototype]] を proto に設定する。
- O を返す。
OrdinaryObjectCreate は
10.1.13 OrdinaryCreateFromConstructor ( constructor, intrinsicDefaultProto [ , internalSlotsList ] )
抽象操作 OrdinaryCreateFromConstructor は、引数 constructor（
保証 ：intrinsicDefaultProto はこの仕様のインストリンシックオブジェクト名であり、対応するオブジェクトはオブジェクトの [[Prototype]] 値として使用することを意図したインストリンシックでなければならない。- proto を ?
GetPrototypeFromConstructor (constructor, intrinsicDefaultProto) とする。 - もし internalSlotsList が存在するなら、slotsList を internalSlotsList とする。
- それ以外の場合、slotsList を新たな空の
List とする。 - Return
OrdinaryObjectCreate (proto, slotsList)。
10.1.14 GetPrototypeFromConstructor ( constructor, intrinsicDefaultProto )
抽象操作 GetPrototypeFromConstructor は、引数 constructor（
保証 ：intrinsicDefaultProto はこの仕様のインストリンシックオブジェクト名であり、対応するオブジェクトはオブジェクトの [[Prototype]] 値として使用することを意図したインストリンシックでなければならない。- proto を ?
Get (constructor,"prototype" ) とする。 - もし proto
がオブジェクトでない なら、- realm を ?
GetFunctionRealm (constructor) とする。 - proto を realm の intrinsicDefaultProto という名前のインストリンシックオブジェクトに設定する。
- realm を ?
- proto を返す。
constructor が [[Prototype]] 値を提供しない場合、使用されるデフォルト値は
constructor 関数の
10.1.15 RequireInternalSlot ( O, internalSlot )
抽象操作RequireInternalSlotは、引数O（
- もしOが
オブジェクトでない なら、TypeError 例外をスローする。 - もしOがinternalSlot内部スロットを持たないなら、
TypeError 例外をスローする。 unused を返す。
10.2 ECMAScript関数オブジェクト
ECMAScriptの
[[Extensible]]および[[Prototype]]に加え、ECMAScript
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[Environment]] |
|
この関数がクロージャした |
| [[PrivateEnvironment]] |
|
この関数がクロージャした |
| [[FormalParameters]] |
|
関数の仮引数リストを定義するソーステキストのルート構文ノード。 |
| [[ECMAScriptCode]] |
|
関数本体を定義するソーステキストのルート構文ノード。 |
| [[ConstructorKind]] |
|
この関数が派生クラスの |
| [[Realm]] |
|
この関数が作成された |
| [[ScriptOrModule]] |
|
この関数が作成されたスクリプトまたはモジュール。 |
| [[ThisMode]] |
|
関数の仮引数および本体内でthis参照がどのように解釈されるかを定義する。thisがレキシカルに囲んでいる関数の |
| [[Strict]] | Boolean |
|
| [[HomeObject]] | オブジェクト |
関数がsuperを使用する場合、superプロパティ検索の起点となるオブジェクトの[[GetPrototypeOf]]を提供するオブジェクト。
|
| [[SourceText]] | Unicodeコードポイント列 |
関数を定義する |
| [[Fields]] |
|
関数がクラスである場合、クラスの非staticフィールドおよびそれに対応する初期化子を表す |
| [[PrivateMethods]] |
|
関数がクラスである場合、クラスの非staticなプライベートメソッドとアクセサを表すリスト。 |
| [[ClassFieldInitializerName]] |
文字列、シンボル、 |
関数がクラスフィールドの初期化子として生成された場合、そのフィールドの |
| [[IsClassConstructor]] | Boolean |
関数がクラスの |
すべてのECMAScript
10.2.1 [[Call]] ( thisArgument, argumentsList )
ECMAScriptの
- callerContextを
実行中の実行コンテキスト とする。 - calleeContextを
PrepareForOrdinaryCall (F,undefined )とする。 保証 ：calleeContextは現在実行中の実行コンテキスト である。- もしF.[[IsClassConstructor]]が
true なら、- errorを新しく生成した
TypeError オブジェクトとする。 - 注：errorはcalleeContext内で、Fに関連付けられた
Realm Record で作成される。 - calleeContextを
実行コンテキストスタック から除去し、callerContextを実行中の実行コンテキスト として復元する。 ThrowCompletion (error)を返す。
- errorを新しく生成した
OrdinaryCallBindThis (F, calleeContext, thisArgument)を実行する。- resultを
Completion (OrdinaryCallEvaluateBody (F, argumentsList))とする。 - calleeContextを
実行コンテキストスタック から除去し、callerContextを実行中の実行コンテキスト として復元する。 - もしresultが
return completion なら、result.[[Value]]を返す。 保証 ：resultはthrow completion である。- ? resultを返す。
ステップ
10.2.1.1 PrepareForOrdinaryCall ( F, newTarget )
抽象操作PrepareForOrdinaryCallは、引数F（ECMAScript
- callerContextを
実行中の実行コンテキスト とする。 - calleeContextを新しい
ECMAScriptコード実行コンテキスト とする。 - calleeContextのFunctionをFに設定する。
- calleeRealmをF.[[Realm]]とする。
- calleeContextの
Realm をcalleeRealmに設定する。 - calleeContextのScriptOrModuleをF.[[ScriptOrModule]]に設定する。
- localEnvを
NewFunctionEnvironment (F, newTarget)とする。 - calleeContextのLexicalEnvironmentをlocalEnvに設定する。
- calleeContextのVariableEnvironmentをlocalEnvに設定する。
- calleeContextのPrivateEnvironmentをF.[[PrivateEnvironment]]に設定する。
- もしcallerContextがすでにサスペンドされていなければ、callerContextをサスペンドする。
- calleeContextを
実行コンテキストスタック にプッシュする；calleeContextは現在の実行中の実行コンテキスト である。 - 注：この時点以降に生成される例外オブジェクトはcalleeRealmに関連付けられる。
- calleeContextを返す。
10.2.1.2 OrdinaryCallBindThis ( F, calleeContext, thisArgument )
抽象操作OrdinaryCallBindThisは、引数F（ECMAScript
- thisModeをF.[[ThisMode]]とする。
- もしthisModeが
lexical なら、unused を返す。 - calleeRealmをF.[[Realm]]とする。
- localEnvをcalleeContextのLexicalEnvironmentとする。
- もしthisModeが
strict なら、- thisValueをthisArgumentとする。
- それ以外の場合、
- もしthisArgumentが
undefined またはnull のいずれかなら、- globalEnvをcalleeRealm.[[GlobalEnv]]とする。
保証 ：globalEnvはグローバル環境レコード である。- thisValueをglobalEnv.[[GlobalThisValue]]とする。
- それ以外の場合、
- もしthisArgumentが
保証 ：localEnvは関数環境レコード である。保証 ：次のステップはlocalEnv.[[ThisBindingStatus]]がinitialized でないのでabrupt completion を返すことはない。- !
BindThisValue (localEnv, thisValue)を実行する。 unused を返す。
10.2.1.3 ランタイムセマンティクス: EvaluateBody
- ?
EvaluateFunctionBody ofFunctionBody を、引数functionObjectおよびargumentsListで呼び出して返す。
- ?
EvaluateConciseBody ofConciseBody を、引数functionObjectおよびargumentsListで呼び出して返す。
- ?
EvaluateGeneratorBody ofGeneratorBody を、引数functionObjectおよびargumentsListで呼び出して返す。
- ?
EvaluateAsyncGeneratorBody ofAsyncGeneratorBody を、引数functionObjectおよびargumentsListで呼び出して返す。
- ?
EvaluateAsyncFunctionBody ofAsyncFunctionBody を、引数functionObjectおよびargumentsListで呼び出して返す。
- ?
EvaluateAsyncConciseBody ofAsyncConciseBody を、引数functionObjectおよびargumentsListで呼び出して返す。
保証 ：argumentsListは空である。保証 ：functionObject.[[ClassFieldInitializerName]]はempty でない。- もし
IsAnonymousFunctionDefinition (AssignmentExpression )がtrue なら、- valueを?
NamedEvaluation ofInitializer を、引数functionObject.[[ClassFieldInitializerName]]で呼び出して得る。
- valueを?
- それ以外の場合、
- rhsを?
Evaluation ofAssignmentExpression で呼び出して得る。 - valueを?
GetValue (rhs)で得る。
- rhsを?
ReturnCompletion (value)を返す。
フィールド初期化子は関数境界を構成するが、
保証 ：argumentsListは空である。- ?
EvaluateClassStaticBlockBody ofClassStaticBlockBody を引数functionObjectで呼び出して返す。
10.2.1.4 OrdinaryCallEvaluateBody ( F, argumentsList )
抽象操作OrdinaryCallEvaluateBodyは引数F（ECMAScript
- ?
EvaluateBody of F.[[ECMAScriptCode]] を、引数FおよびargumentsListで呼び出して返す。
10.2.2 [[Construct]] ( argumentsList, newTarget )
ECMAScriptの
- callerContextを
実行中の実行コンテキスト とする。 - kindをF.[[ConstructorKind]]とする。
- もしkindが
base なら、- thisArgumentを?
OrdinaryCreateFromConstructor (newTarget,"%Object.prototype%" )とする。
- thisArgumentを?
- calleeContextを
PrepareForOrdinaryCall (F, newTarget)とする。 保証 ：calleeContextは現在実行中の実行コンテキスト である。- もしkindが
base なら、OrdinaryCallBindThis (F, calleeContext, thisArgument)を実行する。- initializeResultを
Completion (InitializeInstanceElements (thisArgument, F))とする。 - もしinitializeResultが
abrupt completion なら、- calleeContextを
実行コンテキストスタック から除去し、callerContextを実行中の実行コンテキスト として復元する。 - ? initializeResultを返す。
- calleeContextを
- constructorEnvをcalleeContextのLexicalEnvironmentとする。
- resultを
Completion (OrdinaryCallEvaluateBody (F, argumentsList))とする。 - calleeContextを
実行コンテキストスタック から除去し、callerContextを実行中の実行コンテキスト として復元する。 - もしresultが
throw completion なら、- ? resultを返す。
保証 ：resultはreturn completion である。- もしresult.[[Value]]が
オブジェクトである なら、result.[[Value]]を返す。 - もしkindが
base なら、thisArgumentを返す。 - もしresult.[[Value]]が
undefined でないなら、TypeError 例外をスローする。 - thisBindingを? constructorEnv.GetThisBinding()とする。
保証 ：thisBindingはオブジェクトである 。- thisBindingを返す。
10.2.3 OrdinaryFunctionCreate ( functionPrototype, sourceText, ParameterList, Body, thisMode, env, privateEnv )
抽象操作OrdinaryFunctionCreateは、引数functionPrototype（オブジェクト）、sourceText（Unicodeコードポイント列）、ParameterList（
- internalSlotsListを
表30 に示す内部スロットとする。 - Fを
OrdinaryObjectCreate (functionPrototype, internalSlotsList)とする。 - F.[[Call]]を
10.2.1 で規定される定義に設定する。 - F.[[SourceText]]をsourceTextに設定する。
- F.[[FormalParameters]]をParameterListに設定する。
- F.[[ECMAScriptCode]]をBodyに設定する。
- Strictを
IsStrict (Body)とする。 - F.[[Strict]]をStrictに設定する。
- もしthisModeが
lexical-this なら、F.[[ThisMode]]をlexical に設定する。 - それ以外でStrictが
true なら、F.[[ThisMode]]をstrict に設定する。 - それ以外の場合、F.[[ThisMode]]を
global に設定する。 - F.[[IsClassConstructor]]を
false に設定する。 - F.[[Environment]]をenvに設定する。
- F.[[PrivateEnvironment]]をprivateEnvに設定する。
- F.[[ScriptOrModule]]を
GetActiveScriptOrModule ()に設定する。 - F.[[Realm]]を
現在のRealm Record に設定する。 - F.[[HomeObject]]を
undefined に設定する。 - F.[[Fields]]を新たな空の
List に設定する。 - F.[[PrivateMethods]]を新たな空の
List に設定する。 - F.[[ClassFieldInitializerName]]を
empty に設定する。 - lenを
ExpectedArgumentCount of ParameterListとする。 SetFunctionLength (F, len)を実行する。- Fを返す。
10.2.4 AddRestrictedFunctionProperties ( F, realm )
抽象操作AddRestrictedFunctionPropertiesは、引数F（
保証 ：realm.[[Intrinsics]].[[%ThrowTypeError% ]]が存在し初期化されている。- throwerをrealm.[[Intrinsics]].[[
%ThrowTypeError% ]]とする。 - !
DefinePropertyOrThrow (F,"caller" , PropertyDescriptor { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 - !
DefinePropertyOrThrow (F,"arguments" , PropertyDescriptor { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 unused を返す。
10.2.4.1 %ThrowTypeError% ( )
この関数は%ThrowTypeError%固有オブジェクトである。
これは各
呼び出されたとき、次の手順を実行する：
TypeError 例外をスローする。
この関数の[[Extensible]]内部スロットの値は
この関数の
この関数の
10.2.5 MakeConstructor ( F [ , writablePrototype [ , prototype ] ] )
抽象操作MakeConstructorは、引数F（ECMAScript
- もしFがECMAScript
関数オブジェクト なら、保証 ：IsConstructor (F)はfalse 。保証 ：Fは拡張可能なオブジェクトであり、かつ"prototype" 独自プロパティを持たない。- F.[[Construct]]を
10.2.2 で規定される定義に設定する。
- それ以外の場合、
- F.[[Construct]]を
10.3.2 で規定される定義に設定する。
- F.[[Construct]]を
- F.[[ConstructorKind]]を
base に設定する。 - もしwritablePrototypeが指定されていなければ、writablePrototypeを
true に設定する。 - もしprototypeが指定されていなければ、
- prototypeを
OrdinaryObjectCreate (%Object.prototype% )に設定する。 - !
DefinePropertyOrThrow (prototype,"constructor" , PropertyDescriptor { [[Value]]: F, [[Writable]]: writablePrototype, [[Enumerable]]:false , [[Configurable]]:true }) を実行する。
- prototypeを
- !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]: writablePrototype, [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 unused を返す。
10.2.6 MakeClassConstructor ( F )
抽象操作MakeClassConstructorは、引数F（ECMAScript
保証 ：F.[[IsClassConstructor]]はfalse である。- F.[[IsClassConstructor]]を
true に設定する。 unused を返す。
10.2.7 MakeMethod ( F, homeObject )
抽象操作MakeMethodは、引数F（ECMAScript
10.2.8 DefineMethodProperty ( homeObject, key, closure, enumerable )
抽象操作DefineMethodPropertyは、引数homeObject（オブジェクト）、key（
保証 ：homeObjectは通常かつ拡張可能なオブジェクトである。- もしkeyが
Private Name なら、PrivateElement { [[Key]]: key, [[Kind]]:method , [[Value]]: closure } を返す。
- それ以外の場合、
- descをPropertyDescriptor { [[Value]]:
closure, [[Writable]]:
true , [[Enumerable]]: enumerable, [[Configurable]]:true } とする。 - ?
DefinePropertyOrThrow (homeObject, key, desc)を実行する。 - 注：
DefinePropertyOrThrow がabrupt completion を返すのは、クラスstaticメソッドでkeyが"prototype" の場合のみである。 unused を返す。
- descをPropertyDescriptor { [[Value]]:
closure, [[Writable]]:
10.2.9 SetFunctionName ( F, name [ , prefix ] )
抽象操作SetFunctionNameは、引数F（
保証 ：Fは拡張可能なオブジェクトであり、"name" 独自プロパティを持たない。- もしnameが
シンボルである なら、- descriptionをnameの[[Description]]値とする。
- もしdescriptionが
undefined なら、nameを空文字列に設定する。 - それ以外の場合、nameを
文字列連結 で"[" 、description、"]" を連結したものに設定する。
- それ以外でnameが
Private Name なら、- nameをname.[[Description]]に設定する。
- もしFが[[InitialName]]内部スロットを持つなら、
- F.[[InitialName]]をnameに設定する。
- もしprefixが指定されているなら、
- nameを
文字列連結 でprefix、コード単位0x0020（SPACE）、nameを連結したものに設定する。 - もしFが[[InitialName]]内部スロットを持つなら、
- （任意で）F.[[InitialName]]をnameに設定してもよい。
- nameを
- !
DefinePropertyOrThrow (F,"name" , PropertyDescriptor { [[Value]]: name, [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 unused を返す。
10.2.10 SetFunctionLength ( F, length )
抽象操作SetFunctionLengthは、引数F（
保証 ：Fは拡張可能なオブジェクトであり、"length" 独自プロパティを持たない。- !
DefinePropertyOrThrow (F,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 unused を返す。
10.2.11 FunctionDeclarationInstantiation ( func, argumentsList )
抽象操作FunctionDeclarationInstantiationは、引数func（ECMAScript
呼び出されたとき、次の手順を実行する：
- calleeContextを
実行中の実行コンテキスト とする。 - codeをfunc.[[ECMAScriptCode]]とする。
- strictをfunc.[[Strict]]とする。
- formalsをfunc.[[FormalParameters]]とする。
- parameterNamesを
BoundNames of formalsとする。 - もしparameterNamesに重複があれば、hasDuplicatesを
true 、なければfalse とする。 - simpleParameterListを
IsSimpleParameterList of formalsとする。 - hasParameterExpressionsを
ContainsExpression of formalsとする。 - varNamesを
VarDeclaredNames of codeとする。 - varDeclarationsを
VarScopedDeclarations of codeとする。 - lexicalNamesを
LexicallyDeclaredNames of codeとする。 - functionNamesを新しい空の
List とする。 - functionsToInitializeを新しい空の
List とする。 - varDeclarationsの各要素dについて、逆順で、以下を行う：
- もしdが
VariableDeclaration でもForBinding でもBindingIdentifier でもない場合、保証 ：dはFunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである。- fnを
BoundNames of dの唯一の要素とする。 - もしfunctionNamesがfnを含まないなら、
- fnをfunctionNamesの先頭に挿入する。
- 注：同じ名前の関数宣言が複数ある場合、最後の宣言が使用される。
- dをfunctionsToInitializeの先頭に挿入する。
- もしdが
- argumentsObjectNeededを
true とする。 - もしfunc.[[ThisMode]]が
lexical なら、- 注：アロー関数はargumentsオブジェクトを持たない。
- argumentsObjectNeededを
false に設定する。
- それ以外でparameterNamesが
"arguments" を含む場合、- argumentsObjectNeededを
false に設定する。
- argumentsObjectNeededを
- それ以外でhasParameterExpressionsが
false の場合、- もしfunctionNamesが
"arguments" を含むかlexicalNamesが"arguments" を含むなら、- argumentsObjectNeededを
false に設定する。
- argumentsObjectNeededを
- もしfunctionNamesが
- もしstrictが
true またはhasParameterExpressionsがfalse なら、- 注：パラメータ用には1つの
環境レコード だけが必要。strictモードコード内でのevalの呼び出しは、そのevalの外側で見える新しい束縛を作成できないため。 - envをcalleeContextのLexicalEnvironmentとする。
- 注：パラメータ用には1つの
- それ以外の場合、
- 注：仮引数リスト内のdirect eval呼び出しで作成される束縛がパラメータ宣言環境の外側になるよう、別の
環境レコード が必要となる。 - calleeEnvをcalleeContextのLexicalEnvironmentとする。
- envを
NewDeclarativeEnvironment (calleeEnv)とする。 保証 ：calleeContextのVariableEnvironmentとcalleeEnvは同じ環境レコード である。- calleeContextのLexicalEnvironmentをenvに設定する。
- 注：仮引数リスト内のdirect eval呼び出しで作成される束縛がパラメータ宣言環境の外側になるよう、別の
- parameterNamesの各文字列paramNameについて、以下を行う：
- もしargumentsObjectNeededが
true なら、- もしstrictが
true またはsimpleParameterListがfalse なら、- aoを
CreateUnmappedArgumentsObject (argumentsList)とする。
- aoを
- それ以外の場合、
- 注：マップドargumentsオブジェクトは、restパラメータやパラメータデフォルト値初期化子、分割代入パラメータを持たない
非厳格関数 でのみ提供される。 - aoを
CreateMappedArgumentsObject (func, formals, argumentsList, env)とする。
- 注：マップドargumentsオブジェクトは、restパラメータやパラメータデフォルト値初期化子、分割代入パラメータを持たない
- もしstrictが
true なら、- ! env.CreateImmutableBinding(
"arguments" ,false )を実行する。 - 注：
strictモードコード では早期エラー により、この束縛への代入は試みられないため、そのミュータビリティは観測できない。
- ! env.CreateImmutableBinding(
- それ以外の場合、
- ! env.CreateMutableBinding(
"arguments" ,false )を実行する。
- ! env.CreateMutableBinding(
- ! env.InitializeBinding(
"arguments" , ao)を実行する。 - parameterBindingsを
list-concatenation of parameterNamesと«"arguments" »とする。
- もしstrictが
- それ以外の場合、
- parameterBindingsをparameterNamesとする。
- iteratorRecordを
CreateListIteratorRecord (argumentsList)とする。 - もしhasDuplicatesが
true なら、- usedEnvを
undefined とする。
- usedEnvを
- それ以外の場合、
- usedEnvをenvとする。
- 注：次のステップは、式位置で
ReturnCompletion を返すことはできない。なぜならそのようなcompletionはYieldExpression の使用のみで発生しうるが、これは早期エラー規則(15.5.1 ,15.6.1 )によってパラメータリスト内で禁止されている。 - ?
IteratorBindingInitialization of formals with arguments iteratorRecord and usedEnvを実行する。 - もしhasParameterExpressionsが
false なら、 - それ以外の場合、
- 注：仮引数リスト内の式で作成されるクロージャが関数本体の宣言を見ることができないよう、別の
環境レコード が必要。 - varEnvを
NewDeclarativeEnvironment (env)とする。 - calleeContextのVariableEnvironmentをvarEnvに設定する。
- instantiatedVarNamesを新しい空の
List とする。 - varNamesの各要素nについて、
- もしinstantiatedVarNamesがnを含まないなら、
- nをinstantiatedVarNamesに追加する。
- ! varEnv.CreateMutableBinding(n,
false )を実行する。 - もしparameterBindingsがnを含まないか、またはfunctionNamesがnを含むなら、
- initialValueを
undefined とする。
- initialValueを
- それ以外の場合、
- initialValueを!
env.GetBindingValue(n,
false )とする。
- initialValueを!
env.GetBindingValue(n,
- ! varEnv.InitializeBinding(n, initialValue)を実行する。
- 注：仮引数と同じ名前のvarは、初期状態で対応する初期化済みパラメータと同じ値を持つ。
- もしinstantiatedVarNamesがnを含まないなら、
- 注：仮引数リスト内の式で作成されるクロージャが関数本体の宣言を見ることができないよう、別の
- 注：付録
B.3.2.1 がこの地点で追加のステップを挿入する。 - もしstrictが
false なら、- lexEnvを
NewDeclarativeEnvironment (varEnv)とする。 - 注：
非厳格関数 はトップレベルのレキシカル宣言のために別の環境レコード を使う。こうすることでdirect eval がevalコードで導入されたvarスコープ宣言が既存のトップレベルレキシカルスコープ宣言と衝突するかどうか判定できる。これはstrict関数 では不要であり、strictなdirect eval は常に全ての宣言を新しい環境レコード に配置するためである。
- lexEnvを
- それ以外の場合、
- lexEnvをvarEnvとする。
- calleeContextのLexicalEnvironmentをlexEnvに設定する。
- lexDeclarationsを
LexicallyScopedDeclarations of codeとする。 - lexDeclarationsの各要素dについて、以下を行う：
- 注：レキシカル宣言名は関数/ジェネレーター宣言、仮引数、var名と重複しない。レキシカル宣言名はここでインスタンス化されるが初期化はされない。
BoundNames of dの各要素dnについて、- もし
IsConstantDeclaration of dがtrue なら、- ! lexEnv.CreateImmutableBinding(dn,
true )を実行する。
- ! lexEnv.CreateImmutableBinding(dn,
- それ以外の場合、
- ! lexEnv.CreateMutableBinding(dn,
false )を実行する。
- ! lexEnv.CreateMutableBinding(dn,
- もし
- privateEnvをcalleeContextのPrivateEnvironmentとする。
- functionsToInitializeの各
Parse Node fについて、- fnを
BoundNames of fの唯一の要素とする。 - foを
InstantiateFunctionObject of f with arguments lexEnvとprivateEnvとする。 - ! varEnv.SetMutableBinding(fn, fo,
false )を実行する。
- fnを
unused を返す。
10.3 組み込み関数オブジェクト
組み込み
すべての
- [[Realm]]：関数が作成された
Realm Record 。これはrealm を表す。 - [[InitialName]]：関数の初期名となる文字列。
20.2.3.5 で使用される。
組み込み
組み込み
組み込み
実装は、本仕様で定義されていない追加の組み込み
10.3.1 [[Call]] ( thisArgument, argumentsList )
組み込み
- ?
BuiltinCallOrConstruct (F, thisArgument, argumentsList,undefined )を返す。
10.3.2 [[Construct]] ( argumentsList, newTarget )
組み込み
- resultを?
BuiltinCallOrConstruct (F,uninitialized , argumentsList, newTarget)とする。 保証 ：resultはオブジェクトである 。- resultを返す。
10.3.3 BuiltinCallOrConstruct ( F, thisArgument, argumentsList, newTarget )
抽象操作BuiltinCallOrConstructは、引数F（組み込み
- callerContextを
実行中の実行コンテキスト とする。 - もしcallerContextがすでにサスペンドされていなければ、callerContextをサスペンドする。
- calleeContextを新しい
実行コンテキスト とする。 - calleeContextのFunctionをFに設定する。
- calleeRealmをF.[[Realm]]とする。
- calleeContextの
Realm をcalleeRealmに設定する。 - calleeContextのScriptOrModuleを
null に設定する。 - calleeContextに対して必要な
実装依存 の初期化を実行する。 - calleeContextを
実行コンテキストスタック にプッシュする；calleeContextは現在の実行中の実行コンテキスト である。 - resultを
Completion Record とし、「Fを評価する」ことにより得られる。仕様で定めるように、thisArgumentがuninitialized ならthis 値は初期化されない。それ以外の場合はthisArgumentがthis 値となる。argumentsListは指定されたパラメータを与え、newTargetはNewTarget値を与える。 - 注：Fが本ドキュメントで定義されている場合、「Fの仕様」とは、ステップあるいはその他の手段で規定されるその挙動である。
- calleeContextを
実行コンテキストスタック から除去し、callerContextを実行中の実行コンテキスト として復元する。 - ? resultを返す。
calleeContextが
10.3.4 CreateBuiltinFunction ( behaviour, length, name, additionalInternalSlotsList [ , realm [ , prototype [ , prefix ] ] ] )
抽象操作CreateBuiltinFunctionは、引数behaviour（
- もしrealmが指定されていなければ、realmを
現在のRealm Record に設定する。 - もしprototypeが指定されていなければ、prototypeをrealm.[[Intrinsics]].[[
%Function.prototype% ]]に設定する。 - internalSlotsListを
List とし、これから作成する組み込み関数オブジェクト に10.3 が要求するすべての内部スロット名を入れる。 - internalSlotsListにadditionalInternalSlotsListの要素を追加する。
- funcを新しい組み込み
関数オブジェクト とし、呼び出されたときbehaviourで規定された動作を、指定された引数をbehaviourで指定されたパラメータ値として用いて実行するものとする。新しい関数オブジェクト はinternalSlotsListの名前を持つ内部スロットと、[[InitialName]]内部スロットを持つ。 - func.[[Prototype]]をprototypeに設定する。
- func.[[Extensible]]を
true に設定する。 - func.[[Realm]]をrealmに設定する。
- func.[[InitialName]]を
null に設定する。 SetFunctionLength (func, length)を実行する。- もしprefixが指定されていなければ、
SetFunctionName (func, name)を実行する。
- それ以外の場合、
SetFunctionName (func, name, prefix)を実行する。
- funcを返す。
本仕様で定義される各組み込み関数は、CreateBuiltinFunction抽象操作の呼び出しにより生成される。
10.4 組み込みエキゾチックオブジェクトの内部メソッドとスロット
本仕様は複数の種類の組み込み
10.4.1 バウンド関数エキゾチックオブジェクト
あるオブジェクトがバウンド関数エキゾチックオブジェクトであるのは、その[[Call]]および（該当する場合）[[Construct]]内部メソッドが以下の実装を用い、それ以外の必須内部メソッドが
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[BoundTargetFunction]] | 呼び出し可能オブジェクト |
ラップされている |
| [[BoundThis]] |
|
ラップされた関数を呼び出す際に常に |
| [[BoundArguments]] |
|
ラップされた関数への呼び出しで最初の引数として使用される値のリスト。 |
10.4.1.1 [[Call]] ( thisArgument, argumentsList )
- targetをF.[[BoundTargetFunction]]とする。
- boundThisをF.[[BoundThis]]とする。
- boundArgsをF.[[BoundArguments]]とする。
- argsを
list-concatenation of boundArgsとargumentsListとする。 - ?
Call (target, boundThis, args)を返す。
10.4.1.2 [[Construct]] ( argumentsList, newTarget )
- targetをF.[[BoundTargetFunction]]とする。
保証 ：IsConstructor (target)はtrue である。- boundArgsをF.[[BoundArguments]]とする。
- argsを
list-concatenation of boundArgsとargumentsListとする。 - もし
SameValue (F, newTarget)がtrue なら、newTargetをtargetとする。 - ?
Construct (target, args, newTarget)を返す。
10.4.1.3 BoundFunctionCreate ( targetFunction, boundThis, boundArgs )
抽象操作BoundFunctionCreateは、引数targetFunction（
- protoを? targetFunction.[[GetPrototypeOf]]()とする。
- internalSlotsListを
list-concatenation of « [[Prototype]], [[Extensible]] » および表31 に挙げられている内部スロットとする。 - objを
MakeBasicObject (internalSlotsList)とする。 - obj.[[Prototype]]をprotoに設定する。
- obj.[[Call]]を
10.4.1.1 で説明されるものに設定する。 - もし
IsConstructor (targetFunction)がtrue なら、- obj.[[Construct]]を
10.4.1.2 で説明されるものに設定する。
- obj.[[Construct]]を
- obj.[[BoundTargetFunction]]をtargetFunctionに設定する。
- obj.[[BoundThis]]をboundThisに設定する。
- obj.[[BoundArguments]]をboundArgsに設定する。
- objを返す。
10.4.2 配列エキゾチックオブジェクト
配列（Array）は、
あるオブジェクトの[[DefineOwnProperty]]内部メソッドが以下の実装を使い、それ以外の必須内部メソッドが
10.4.2.1 [[DefineOwnProperty]] ( P, Desc )
- もしPが
"length" なら、- ?
ArraySetLength (A, Desc)を返す。
- ?
- それ以外でPが
配列インデックス なら、- lengthDescを
OrdinaryGetOwnProperty (A,"length" )とする。 保証 ：lengthDescはundefined でない。保証 ：IsDataDescriptor (lengthDesc)はtrue 。保証 ：lengthDesc.[[Configurable]]はfalse 。- lengthをlengthDesc.[[Value]]とする。
保証 ：lengthは0以上の整数値(Number) である。- indexを!
ToUint32 (P)とする。 - もしindex ≥ lengthかつlengthDesc.[[Writable]]が
false なら、false を返す。 - succeededを!
OrdinaryDefineOwnProperty (A, P, Desc)とする。 - もしsucceededが
false なら、false を返す。 - もしindex ≥ lengthなら、
- lengthDesc.[[Value]]をindex +
1 𝔽に設定する。 - succeededを!
OrdinaryDefineOwnProperty (A,"length" , lengthDesc)とする。 保証 ：succeededはtrue 。
- lengthDesc.[[Value]]をindex +
true を返す。
- lengthDescを
- ?
OrdinaryDefineOwnProperty (A, P, Desc)を返す。
10.4.2.2 ArrayCreate ( length [ , proto ] )
抽象操作ArrayCreateは、引数length（0以上の
- もしlength > 232 - 1なら、
RangeError 例外をスローする。 - もしprotoが指定されていなければ、protoを
%Array.prototype% に設定する。 - Aを
MakeBasicObject (« [[Prototype]], [[Extensible]] »)とする。 - A.[[Prototype]]をprotoに設定する。
- A.[[DefineOwnProperty]]を
10.4.2.1 で規定されるものに設定する。 - !
OrdinaryDefineOwnProperty (A,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - Aを返す。
10.4.2.3 ArraySpeciesCreate ( originalArray, length )
抽象操作ArraySpeciesCreateは、引数originalArray（オブジェクト）、length（0以上の
- isArrayを?
IsArray (originalArray)とする。 - もしisArrayが
false なら、?ArrayCreate (length)を返す。 - Cを?
Get (originalArray,"constructor" )とする。 - もし
IsConstructor (C)がtrue なら、- thisRealmを
現在のRealm Record とする。 - realmCを?
GetFunctionRealm (C)とする。 - もしthisRealmとrealmCが同じ
Realm Record でないなら、
- thisRealmを
- もしCが
オブジェクトである なら、- Cを?
Get (C,%Symbol.species% )に設定する。 - もしCが
null なら、Cをundefined に設定する。
- Cを?
- もしCが
undefined なら、?ArrayCreate (length)を返す。 - もし
IsConstructor (C)がfalse なら、TypeError 例外をスローする。 - ?
Construct (C, «𝔽 (length) »)を返す。
もしoriginalArrayが現在のArray.prototypeメソッドがArraySpeciesCreateで定義されるようになったWebブラウザとの互換性を維持する。
10.4.2.4 ArraySetLength ( A, Desc )
抽象操作ArraySetLengthは、引数A（配列）、Desc（
- もしDescが[[Value]]フィールドを持たないなら、
- !
OrdinaryDefineOwnProperty (A,"length" , Desc)を返す。
- !
- newLenDescをDescのコピーとする。
- newLenを?
ToUint32 (Desc.[[Value]])とする。 - numberLenを?
ToNumber (Desc.[[Value]])とする。 - もし
SameValueZero (newLen, numberLen)がfalse なら、RangeError 例外をスローする。 - newLenDesc.[[Value]]をnewLenに設定する。
- oldLenDescを
OrdinaryGetOwnProperty (A,"length" )とする。 保証 ：oldLenDescはundefined でない。保証 ：IsDataDescriptor (oldLenDesc)はtrue 。保証 ：oldLenDesc.[[Configurable]]はfalse である。- oldLenをoldLenDesc.[[Value]]とする。
- もしnewLen ≥ oldLenなら、
- !
OrdinaryDefineOwnProperty (A,"length" , newLenDesc)を返す。
- !
- もしoldLenDesc.[[Writable]]が
false なら、false を返す。 - もしnewLenDescが[[Writable]]フィールドを持たないかnewLenDesc.[[Writable]]が
true なら、- newWritableを
true とする。
- newWritableを
- それ以外の場合、
- 注：[[Writable]]属性を
false に設定するのは、要素の削除に失敗した場合に遅延される。 - newWritableを
false とする。 - newLenDesc.[[Writable]]を
true に設定する。
- 注：[[Writable]]属性を
- succeededを!
OrdinaryDefineOwnProperty (A,"length" , newLenDesc)とする。 - もしsucceededが
false なら、false を返す。 - Aのすべての自身の
プロパティキー Pについて、Pが配列インデックス かつ!ToUint32 (P) ≥ newLenであるものを降順で、以下を行う：- deleteSucceededを! A.[[Delete]](P)とする。
- もしdeleteSucceededが
false なら、- newLenDesc.[[Value]]を!
ToUint32 (P) +1 𝔽に設定する。 - もしnewWritableが
false なら、newLenDesc.[[Writable]]をfalse に設定する。 - !
OrdinaryDefineOwnProperty (A,"length" , newLenDesc)を実行する。 false を返す。
- newLenDesc.[[Value]]を!
- もしnewWritableが
false なら、- succeededを!
OrdinaryDefineOwnProperty (A,"length" , PropertyDescriptor { [[Writable]]:false })とする。 保証 ：succeededはtrue である。
- succeededを!
true を返す。
10.4.3 文字列エキゾチックオブジェクト
Stringオブジェクトは、文字列値をカプセル化し、その文字列値の個々のコードユニット要素に対応する仮想の
あるオブジェクトの[[GetOwnProperty]]、[[DefineOwnProperty]]、[[OwnPropertyKeys]]内部メソッドが以下の実装を使い、それ以外の必須内部メソッドが
10.4.3.1 [[GetOwnProperty]] ( P )
- descを
OrdinaryGetOwnProperty (S, P)とする。 - もしdescが
undefined でなければ、descを返す。 StringGetOwnProperty (S, P)を返す。
10.4.3.2 [[DefineOwnProperty]] ( P, Desc )
- stringDescを
StringGetOwnProperty (S, P)とする。 - もしstringDescが
undefined でなければ、- extensibleをS.[[Extensible]]とする。
IsCompatiblePropertyDescriptor (extensible, Desc, stringDesc)を返す。
- !
OrdinaryDefineOwnProperty (S, P, Desc)を返す。
10.4.3.3 [[OwnPropertyKeys]] ( )
- keysを新しい空の
List とする。 - strをO.[[StringData]]とする。
保証 ：strは文字列である 。- lenをstrの長さとする。
- 0 ≤ i < len となる各
整数 iについて、昇順で： - Oの自身の
プロパティキー Pについて、Pが配列インデックス かつ!ToIntegerOrInfinity (P) ≥ lenであるものを昇順で：- Pをkeysに追加する。
- Oの自身の
プロパティキー Pについて、Pが文字列である かつPが配列インデックス でないものを生成順に昇順で：- Pをkeysに追加する。
- Oの自身の
プロパティキー Pについて、Pがシンボルである ものを生成順に昇順で：- Pをkeysに追加する。
- keysを返す。
10.4.3.4 StringCreate ( value, prototype )
抽象操作StringCreateは、引数value（文字列）、prototype（オブジェクト）を取り、
- Sを
MakeBasicObject (« [[Prototype]], [[Extensible]], [[StringData]] »)とする。 - S.[[Prototype]]をprototypeに設定する。
- S.[[StringData]]をvalueに設定する。
- S.[[GetOwnProperty]]を
10.4.3.1 で規定されるものに設定する。 - S.[[DefineOwnProperty]]を
10.4.3.2 で規定されるものに設定する。 - S.[[OwnPropertyKeys]]を
10.4.3.3 で規定されるものに設定する。 - lengthをvalueの長さとする。
- !
DefinePropertyOrThrow (S,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - Sを返す。
10.4.3.5 StringGetOwnProperty ( S, P )
抽象操作StringGetOwnPropertyは、引数S（[[StringData]]内部スロットを持つオブジェクト）、P（
- もしPが
文字列でない なら、undefined を返す。 - indexを
CanonicalNumericIndexString (P)とする。 - もしindexが
整数値(Number) でなければ、undefined を返す。 - もしindexが
-0 𝔽またはindex <-0 𝔽なら、undefined を返す。 - strをS.[[StringData]]とする。
保証 ：strは文字列である 。- lenをstrの長さとする。
- もし
ℝ (index) ≥ lenなら、undefined を返す。 - resultStrをstrの
substring （ℝ (index)からℝ (index)+1まで）とする。 - プロパティディスクリプタ{ [[Value]]: resultStr, [[Writable]]:
false , [[Enumerable]]:true , [[Configurable]]:false }を返す。
10.4.4 Argumentsエキゾチックオブジェクト
ほとんどのECMAScript関数は、コードで利用可能なargumentsオブジェクトを生成する。関数定義の特性によって、そのargumentsオブジェクトは
オブジェクトが、ここで明示されていない内部メソッドについて
Object.prototype.toString（
ParameterMapオブジェクトとそのプロパティ値は、argumentsオブジェクトと引数束縛の連動を規定するための仕組みとして用いられる。ParameterMapオブジェクトおよびそのプロパティ値となるオブジェクトは、ECMAScriptコードから直接観測できない。ECMAScript実装は、規定されたセマンティクスを実装するために実際にこれらのオブジェクトを生成・利用する必要はない。
通常のargumentsオブジェクトは、アクセス時に
ECMAScript実装の
10.4.4.1 [[GetOwnProperty]] ( P )
- descを
OrdinaryGetOwnProperty (args, P)とする。 - もしdescが
undefined なら、undefined を返す。 - mapをargs.[[ParameterMap]]とする。
- isMappedを!
HasOwnProperty (map, P)とする。 - もしisMappedが
true なら、- desc.[[Value]]を!
Get (map, P)に設定する。
- desc.[[Value]]を!
- descを返す。
10.4.4.2 [[DefineOwnProperty]] ( P, Desc )
- mapをargs.[[ParameterMap]]とする。
- isMappedを!
HasOwnProperty (map, P)とする。 - newArgDescをDescとする。
- もしisMappedが
true かつIsDataDescriptor (Desc)がtrue なら、- もしDescが[[Value]]フィールドを持たず、Descが[[Writable]]フィールドを持ち、Desc.[[Writable]]が
false なら、- newArgDescをDescのコピーとする。
- newArgDesc.[[Value]]を!
Get (map, P)に設定する。
- もしDescが[[Value]]フィールドを持たず、Descが[[Writable]]フィールドを持ち、Desc.[[Writable]]が
- allowedを!
OrdinaryDefineOwnProperty (args, P, newArgDesc)とする。 - もしallowedが
false なら、false を返す。 - もしisMappedが
true なら、- もし
IsAccessorDescriptor (Desc)がtrue なら、- ! map.[[Delete]](P)を実行する。
- それ以外の場合、
- もし
true を返す。
10.4.4.3 [[Get]] ( P, Receiver )
- mapをargs.[[ParameterMap]]とする。
- isMappedを!
HasOwnProperty (map, P)とする。 - もしisMappedが
false なら、- ?
OrdinaryGet (args, P, Receiver)を返す。
- ?
- それ以外の場合、
10.4.4.4 [[Set]] ( P, V, Receiver )
- もし
SameValue (args, Receiver)がfalse なら、- isMappedを
false とする。
- isMappedを
- それ以外の場合、
- mapをargs.[[ParameterMap]]とする。
- isMappedを!
HasOwnProperty (map, P)とする。
- もしisMappedが
true なら、 - ?
OrdinarySet (args, P, V, Receiver)を返す。
10.4.4.5 [[Delete]] ( P )
- mapをargs.[[ParameterMap]]とする。
- isMappedを!
HasOwnProperty (map, P)とする。 - resultを?
OrdinaryDelete (args, P)とする。 - もしresultが
true かつisMappedがtrue なら、- ! map.[[Delete]](P)を実行する。
- resultを返す。
10.4.4.6 CreateUnmappedArgumentsObject ( argumentsList )
抽象操作CreateUnmappedArgumentsObjectは、引数argumentsList（
- lenをargumentsListの要素数とする。
- objを
OrdinaryObjectCreate (%Object.prototype% , « [[ParameterMap]] »)とする。 - obj.[[ParameterMap]]を
undefined に設定する。 - !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (len), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 - indexを0とする。
- 繰り返し、index
< lenの間、
- valをargumentsList[index]とする。
- !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), val)を実行する。 - indexをindex + 1に設定する。
- !
DefinePropertyOrThrow (obj,%Symbol.iterator% , PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 - !
DefinePropertyOrThrow (obj,"callee" , PropertyDescriptor { [[Get]]:%ThrowTypeError% , [[Set]]:%ThrowTypeError% , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - objを返す。
10.4.4.7 CreateMappedArgumentsObject ( func, formals, argumentsList, env )
抽象操作CreateMappedArgumentsObjectは、引数func（オブジェクト）、formals（
保証 ：formalsはrestパラメータ、バインディングパターン、初期化子を含まない。ただし重複識別子は許可される。- lenをargumentsListの要素数とする。
- objを
MakeBasicObject (« [[Prototype]], [[Extensible]], [[ParameterMap]] »)とする。 - obj.[[GetOwnProperty]]を
10.4.4.1 で規定されるものに設定する。 - obj.[[DefineOwnProperty]]を
10.4.4.2 で規定されるものに設定する。 - obj.[[Get]]を
10.4.4.3 で規定されるものに設定する。 - obj.[[Set]]を
10.4.4.4 で規定されるものに設定する。 - obj.[[Delete]]を
10.4.4.5 で規定されるものに設定する。 - obj.[[Prototype]]を
%Object.prototype% に設定する。 - mapを
OrdinaryObjectCreate (null )とする。 - obj.[[ParameterMap]]をmapに設定する。
- parameterNamesを
BoundNames of formalsとする。 - numberOfParametersをparameterNamesの要素数とする。
- indexを0とする。
- 繰り返し、index < lenの間、
- valをargumentsList[index]とする。
- !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), val)を実行する。 - indexをindex + 1に設定する。
- !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (len), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 - mappedNamesを新しい空の
List とする。 - indexをnumberOfParameters - 1に設定する。
- 繰り返し、index ≥ 0の間、
- nameをparameterNames[index]とする。
- もしmappedNamesがnameを含まないなら、
- nameをmappedNamesに追加する。
- もしindex < lenなら、
- gを
MakeArgGetter (name, env)とする。 - pを
MakeArgSetter (name, env)とする。 - ! map.[[DefineOwnProperty]](!
ToString (𝔽 (index)), PropertyDescriptor { [[Set]]: p, [[Get]]: g, [[Enumerable]]:false , [[Configurable]]:true }) を実行する。
- gを
- indexをindex - 1に設定する。
- !
DefinePropertyOrThrow (obj,%Symbol.iterator% , PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 - !
DefinePropertyOrThrow (obj,"callee" , PropertyDescriptor { [[Value]]: func, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 - objを返す。
10.4.4.7.1 MakeArgGetter ( name, env )
抽象操作MakeArgGetterは、引数name（文字列）、env（
- getterClosureを新しい
Abstract Closure （パラメータなし、nameとenvをキャプチャ）とし、呼び出されたとき次を行う：NormalCompletion (! env.GetBindingValue(name,false ))を返す。
- getterを
CreateBuiltinFunction (getterClosure, 0,"" , « »)とする。 - 注：getterはECMAScriptコードから直接アクセスされることはない。
- getterを返す。
10.4.4.7.2 MakeArgSetter ( name, env )
抽象操作MakeArgSetterは、引数name（文字列）、env（
- setterClosureを新しい
Abstract Closure （パラメータは(value)、nameとenvをキャプチャ）とし、呼び出されたとき次を行う：NormalCompletion (! env.SetMutableBinding(name, value,false ))を返す。
- setterを
CreateBuiltinFunction (setterClosure, 1,"" , « »)とする。 - 注：setterはECMAScriptコードから直接アクセスされることはない。
- setterを返す。
10.4.5 TypedArray エキゾチックオブジェクト
オブジェクトの[[PreventExtensions]]、[[GetOwnProperty]]、[[HasProperty]]、[[DefineOwnProperty]]、[[Get]]、[[Set]]、[[Delete]]、[[OwnPropertyKeys]]内部メソッドがこの節の定義を、その他の本質的内部メソッドが
10.4.5.1 [[PreventExtensions]] ( )
- 注：
6.1.7.3 で規定される拡張性関連の不変条件により、このメソッドは、Oがプロパティを増やしたり（あるいは失ってから再度増やしたり）できる場合（基礎バッファがリサイズされるときの整数インデックス名のプロパティなど）、true を返すことはできない。 - もし
IsTypedArrayFixedLength (O)がfalse なら、false を返す。 OrdinaryPreventExtensions (O)を返す。
10.4.5.2 [[GetOwnProperty]] ( P )
- もしPが
文字列 なら、- numericIndexを
CanonicalNumericIndexString (P)とする。 - もしnumericIndexが
undefined でなければ、- valueを
TypedArrayGetElement (O, numericIndex)とする。 - もしvalueが
undefined なら、undefined を返す。 - プロパティディスクリプタ { [[Value]]: value,
[[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:true } を返す。
- valueを
- numericIndexを
OrdinaryGetOwnProperty (O, P)を返す。
10.4.5.3 [[HasProperty]] ( P )
- もしPが
文字列 なら、- numericIndexを
CanonicalNumericIndexString (P)とする。 - もしnumericIndexが
undefined でなければ、IsValidIntegerIndex (O, numericIndex)を返す。
- numericIndexを
- ?
OrdinaryHasProperty (O, P)を返す。
10.4.5.4 [[DefineOwnProperty]] ( P, Desc )
- もしPが
文字列 なら、- numericIndexを
CanonicalNumericIndexString (P)とする。 - もしnumericIndexが
undefined でなければ、- もし
IsValidIntegerIndex (O, numericIndex)がfalse なら、false を返す。 - もしDescが[[Configurable]]フィールドを持ち、かつDesc.[[Configurable]]が
false なら、false を返す。 - もしDescが[[Enumerable]]フィールドを持ち、かつDesc.[[Enumerable]]が
false なら、false を返す。 - もし
IsAccessorDescriptor (Desc)がtrue なら、false を返す。 - もしDescが[[Writable]]フィールドを持ち、かつDesc.[[Writable]]が
false なら、false を返す。 - もしDescが[[Value]]フィールドを持つなら、?
TypedArraySetElement (O, numericIndex, Desc.[[Value]])を実行する。 true を返す。
- もし
- numericIndexを
- !
OrdinaryDefineOwnProperty (O, P, Desc)を返す。
10.4.5.5 [[Get]] ( P, Receiver )
- もしPが
文字列 なら、- numericIndexを
CanonicalNumericIndexString (P)とする。 - もしnumericIndexが
undefined でなければ、TypedArrayGetElement (O, numericIndex)を返す。
- numericIndexを
- ?
OrdinaryGet (O, P, Receiver)を返す。
10.4.5.6 [[Set]] ( P, V, Receiver )
- もしPが
文字列 なら、- numericIndexを
CanonicalNumericIndexString (P)とする。 - もしnumericIndexが
undefined でなければ、- もし
SameValue (O, Receiver)がtrue なら、- ?
TypedArraySetElement (O, numericIndex, V)を実行する。 true を返す。
- ?
- もし
IsValidIntegerIndex (O, numericIndex)がfalse なら、true を返す。
- もし
- numericIndexを
- ?
OrdinarySet (O, P, V, Receiver)を返す。
10.4.5.7 [[Delete]] ( P )
- もしPが
文字列 なら、- numericIndexを
CanonicalNumericIndexString (P)とする。 - もしnumericIndexが
undefined でなければ、- もし
IsValidIntegerIndex (O, numericIndex)がfalse ならtrue 、そうでなければfalse を返す。
- もし
- numericIndexを
- !
OrdinaryDelete (O, P)を返す。
10.4.5.8 [[OwnPropertyKeys]] ( )
- taRecordを
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )とする。 - keysを新しい空の
List とする。 - もし
IsTypedArrayOutOfBounds (taRecord)がfalse なら、- lengthを
TypedArrayLength (taRecord)とする。 - 0 ≤ i < length となる各
整数 iについて、昇順で：
- lengthを
- Oの自身の
プロパティキー Pについて、Pが文字列 かつPが整数インデックス でないものを生成順に昇順で：- Pをkeysに追加する。
- Oの自身の
プロパティキー Pについて、Pがシンボル であるものを生成順に昇順で：- Pをkeysに追加する。
- keysを返す。
10.4.5.9 バッファ証人レコード付きTypedArray
バッファ証人レコード付きTypedArrayは、
バッファ証人レコード付きTypedArrayは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Object]] |
|
バッファのバイト長がロードされる |
| [[CachedBufferByteLength]] |
0以上の |
|
10.4.5.10 MakeTypedArrayWithBufferWitnessRecord ( obj, order )
抽象操作MakeTypedArrayWithBufferWitnessRecordは、引数obj（
- bufferをobj.[[ViewedArrayBuffer]]とする。
- もし
IsDetachedBuffer (buffer)がtrue なら、- byteLengthを
detached とする。
- byteLengthを
- それ以外の場合、
- byteLengthを
ArrayBufferByteLength (buffer, order)とする。
- byteLengthを
バッファ証人レコード付きTypedArray { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength }を返す。
10.4.5.11 TypedArrayCreate ( prototype )
抽象操作TypedArrayCreateは、引数prototype（オブジェクト）を取り、
- internalSlotsListを« [[Prototype]], [[Extensible]], [[ViewedArrayBuffer]], [[TypedArrayName]], [[ContentType]], [[ByteLength]], [[ByteOffset]], [[ArrayLength]] »とする。
- Aを
MakeBasicObject (internalSlotsList)とする。 - A.[[PreventExtensions]]を
10.4.5.1 で規定されるものに設定する。 - A.[[GetOwnProperty]]を
10.4.5.2 で規定されるものに設定する。 - A.[[HasProperty]]を
10.4.5.3 で規定されるものに設定する。 - A.[[DefineOwnProperty]]を
10.4.5.4 で規定されるものに設定する。 - A.[[Get]]を
10.4.5.5 で規定されるものに設定する。 - A.[[Set]]を
10.4.5.6 で規定されるものに設定する。 - A.[[Delete]]を
10.4.5.7 で規定されるものに設定する。 - A.[[OwnPropertyKeys]]を
10.4.5.8 で規定されるものに設定する。 - A.[[Prototype]]をprototypeに設定する。
- Aを返す。
10.4.5.12 TypedArrayByteLength ( taRecord )
抽象操作TypedArrayByteLengthは、引数taRecord（
- もし
IsTypedArrayOutOfBounds (taRecord)がtrue なら、0を返す。 - lengthを
TypedArrayLength (taRecord)とする。 - もしlength = 0 なら、0を返す。
- OをtaRecord.[[Object]]とする。
- もしO.[[ByteLength]]が
auto でないなら、O.[[ByteLength]]を返す。 - elementSizeを
TypedArrayElementSize (O)とする。 - length × elementSizeを返す。
10.4.5.13 TypedArrayLength ( taRecord )
抽象操作TypedArrayLengthは、引数taRecord（
保証 ：IsTypedArrayOutOfBounds (taRecord)はfalse である。- OをtaRecord.[[Object]]とする。
- もしO.[[ArrayLength]]が
auto でないなら、O.[[ArrayLength]]を返す。 保証 ：IsFixedLengthArrayBuffer (O.[[ViewedArrayBuffer]])はfalse である。- byteOffsetをO.[[ByteOffset]]とする。
- elementSizeを
TypedArrayElementSize (O)とする。 - byteLengthをtaRecord.[[CachedBufferByteLength]]とする。
保証 ：byteLengthはdetached でない。floor ((byteLength - byteOffset) / elementSize)を返す。
10.4.5.14 IsTypedArrayOutOfBounds ( taRecord )
抽象操作IsTypedArrayOutOfBoundsは、引数taRecord（
- OをtaRecord.[[Object]]とする。
- bufferByteLengthをtaRecord.[[CachedBufferByteLength]]とする。
保証 ：IsDetachedBuffer (O.[[ViewedArrayBuffer]])がtrue となるのはbufferByteLengthがdetached のとき、かつそのときだけである。- もしbufferByteLengthが
detached なら、true を返す。 - byteOffsetStartをO.[[ByteOffset]]とする。
- もしO.[[ArrayLength]]が
auto なら、- byteOffsetEndをbufferByteLengthとする。
- それ以外の場合、
- elementSizeを
TypedArrayElementSize (O)とする。 - byteOffsetEndをbyteOffsetStart + O.[[ArrayLength]] × elementSizeとする。
- elementSizeを
- もしbyteOffsetStart > bufferByteLength または
byteOffsetEnd >
bufferByteLengthなら、
true を返す。 - 注：長さ0の
TypedArray は範囲外とはみなされない。 false を返す。
10.4.5.15 IsTypedArrayFixedLength ( O )
抽象操作IsTypedArrayFixedLengthは、引数O（
- もしO.[[ArrayLength]]が
auto なら、false を返す。 - bufferをO.[[ViewedArrayBuffer]]とする。
- もし
IsFixedLengthArrayBuffer (buffer)がfalse かつIsSharedArrayBuffer (buffer)がfalse なら、false を返す。 true を返す。
10.4.5.16 IsValidIntegerIndex ( O, index )
抽象操作IsValidIntegerIndexは、引数O（
- もし
IsDetachedBuffer (O.[[ViewedArrayBuffer]])がtrue なら、false を返す。 - もしindexが
整数値(Number) でなければ、false を返す。 - もしindexが
-0 𝔽またはindex <-0 𝔽なら、false を返す。 - taRecordを
MakeTypedArrayWithBufferWitnessRecord (O,unordered )とする。 - 注：バッファが拡張可能なSharedArrayBufferの場合、境界チェックは同期化操作ではない。
- もし
IsTypedArrayOutOfBounds (taRecord)がtrue なら、false を返す。 - lengthを
TypedArrayLength (taRecord)とする。 - もし
ℝ (index) ≥ lengthなら、false を返す。 true を返す。
10.4.5.17 TypedArrayGetElement ( O, index )
抽象操作TypedArrayGetElementは、引数O（
- もし
IsValidIntegerIndex (O, index)がfalse なら、undefined を返す。 - offsetをO.[[ByteOffset]]とする。
- elementSizeを
TypedArrayElementSize (O)とする。 - byteIndexInBufferを(
ℝ (index) × elementSize) + offsetとする。 - elementTypeを
TypedArrayElementType (O)とする。 GetValueFromBuffer (O.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType,true ,unordered )を返す。
10.4.5.18 TypedArraySetElement ( O, index, value )
抽象操作 TypedArraySetElement は、引数 O（
- もし O.[[ContentType]] が
bigint なら、numValue に ?ToBigInt (value) を設定する。 - それ以外の場合、numValue に ?
ToNumber (value) を設定する。 IsValidIntegerIndex (O, index) がtrue なら、- offset に O.[[ByteOffset]] を設定する。
- elementSize に
TypedArrayElementSize (O) を設定する。 - byteIndexInBuffer に (
ℝ (index) × elementSize) + offset を設定する。 - elementType に
TypedArrayElementType (O) を設定する。 SetValueInBuffer (O.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType, numValue,true ,unordered ) を実行する。
unused を返す。
この操作は常に成功したように見えるが、
10.4.5.19 IsArrayBufferViewOutOfBounds ( O )
抽象操作 IsArrayBufferViewOutOfBounds は、引数 O（
- もし O が [[DataView]] 内部スロットを持つなら、
- viewRecord に
MakeDataViewWithBufferWitnessRecord (O,seq-cst ) を設定する。 IsViewOutOfBounds (viewRecord) を返す。
- viewRecord に
- taRecord に
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst ) を設定する。 IsTypedArrayOutOfBounds (taRecord) を返す。
10.4.6 モジュール名前空間エキゾチックオブジェクト
export *
によって間接的にエクスポートされたバインディングも含まれる。それぞれの String 値の own
あるオブジェクトが モジュール名前空間エキゾチックオブジェクト であるとは、その [[GetPrototypeOf]]、[[SetPrototypeOf]]、[[IsExtensible]]、[[PreventExtensions]]、[[GetOwnProperty]]、[[DefineOwnProperty]]、[[HasProperty]]、[[Get]]、[[Set]]、[[Delete]]、[[OwnPropertyKeys]] 内部メソッドが本節の定義を使用し、それ以外の本質的な内部メソッドが
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[Module]] |
|
この名前空間が公開するエクスポートを持つ |
| [[Exports]] |
|
このオブジェクトの own プロパティとして公開されているエクスポート名の String 値の |
10.4.6.1 [[GetPrototypeOf]] ( )
null を返す。
10.4.6.2 [[SetPrototypeOf]] ( V )
- !
SetImmutablePrototype (O, V) を返す。
10.4.6.3 [[IsExtensible]] ( )
false を返す。
10.4.6.4 [[PreventExtensions]] ( )
true を返す。
10.4.6.5 [[GetOwnProperty]] ( P )
- もし P が
Symbol である 場合、OrdinaryGetOwnProperty (O, P) を返す。 - exports を O.[[Exports]] とする。
- もし exports が P を含まない場合、
undefined を返す。 - value を ? O.[[Get]](P, O) とする。
- PropertyDescriptor { [[Value]]: value,
[[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:false } を返す。
10.4.6.6 [[DefineOwnProperty]] ( P, Desc )
- もし P が
Symbol である 場合、!OrdinaryDefineOwnProperty (O, P, Desc) を返す。 - current を ? O.[[GetOwnProperty]](P) とする。
- もし current が
undefined なら、false を返す。 - もし Desc が [[Configurable]] フィールドを持ち、かつ
Desc.[[Configurable]] が
true である場合、false を返す。 - もし Desc が [[Enumerable]] フィールドを持ち、かつ
Desc.[[Enumerable]] が
false である場合、false を返す。 - もし
IsAccessorDescriptor (Desc) がtrue なら、false を返す。 - もし Desc が [[Writable]] フィールドを持ち、かつ
Desc.[[Writable]] が
false である場合、false を返す。 - もし Desc が [[Value]] フィールドを持つなら、
SameValue (Desc.[[Value]], current.[[Value]]) を返す。 true を返す。
10.4.6.7 [[HasProperty]] ( P )
- もし P が
Symbol である 場合、!OrdinaryHasProperty (O, P) を返す。 - exports を O.[[Exports]] とする。
- もし exports が P を含む場合、
true を返す。 false を返す。
10.4.6.8 [[Get]] ( P, Receiver )
- もし P が
Symbol である 場合、- !
OrdinaryGet (O, P, Receiver) を返す。
- !
- exports を O.[[Exports]] とする。
- もし exports が P を含まない場合、
undefined を返す。 - m を O.[[Module]] とする。
- binding を m.ResolveExport(P) とする。
アサート ： binding はResolvedBinding レコード である。- targetModule を binding.[[Module]] とする。
アサート ： targetModule はundefined ではない。- もし binding.[[BindingName]] が
namespace である場合、GetModuleNamespace (targetModule) を返す。
- targetEnv を targetModule.[[Environment]] とする。
- もし targetEnv が
empty である場合、ReferenceError 例外をスローする。 - ? targetEnv.GetBindingValue(binding.[[BindingName]],
true ) を返す。
ResolveExport は副作用を持たない。この操作が特定の exportName・resolveSet
の組み合わせで呼ばれるたびに、常に同じ結果を返さなければならない。実装は各 [[Exports]] に対して
ResolveExport の結果を事前計算・キャッシュしてもよい。
10.4.6.9 [[Set]] ( P, V, Receiver )
false を返す。
10.4.6.10 [[Delete]] ( P )
- もし P が
Symbol である 場合、- !
OrdinaryDelete (O, P) を返す。
- !
- exports を O.[[Exports]] とする。
- もし exports が P を含む場合、
false を返す。 true を返す。
10.4.6.11 [[OwnPropertyKeys]] ( )
- exports を O.[[Exports]] とする。
- symbolKeys を
OrdinaryOwnPropertyKeys (O) とする。 リスト連結 により exports と symbolKeys を結合したリストを返す。
10.4.6.12 ModuleNamespaceCreate ( module, exports )
抽象操作 ModuleNamespaceCreate は、引数 module（
アサート ： module.[[Namespace]] はempty である。- internalSlotsList を
表 33 に記載されている内部スロットとする。 - M を
MakeBasicObject (internalSlotsList) とする。 - M の本質的な内部メソッドを
10.4.6 で指定された定義に設定する。 - M.[[Module]] に module を設定する。
- sortedExports を
リスト （要素は exports の要素を辞書式コードユニット順 にソートしたもの）とする。 - M.[[Exports]] に sortedExports を設定する。
- M の own プロパティを
28.3 の定義に対応して作成する。 - module.[[Namespace]] に M を設定する。
- M を返す。
10.4.7 不変プロトタイプエキゾチックオブジェクト
あるオブジェクトが 不変プロトタイプエキゾチックオブジェクト
であるとは、その [[SetPrototypeOf]] 内部メソッドが以下の実装を用いる場合である（その他の本質的な内部メソッドは、対象の
他の
10.4.7.1 [[SetPrototypeOf]] ( V )
- ?
SetImmutablePrototype (O, V) を返す。
10.4.7.2 SetImmutablePrototype ( O, V )
抽象操作 SetImmutablePrototype は、引数 O（Object）、V（Object または
- current を ? O.[[GetPrototypeOf]]() とする。
SameValue (V, current) がtrue なら、true を返す。false を返す。
10.5 Proxy オブジェクトの内部メソッドおよび内部スロット
Proxy オブジェクトは、
あるオブジェクトが Proxy
エキゾチックオブジェクト であるとは、その本質的な内部メソッド（該当する場合は [[Call]] および [[Construct]] を含む）が本節の定義を使う場合である。これらの内部メソッドは
| 内部メソッド | ハンドラーメソッド |
|---|---|
| [[GetPrototypeOf]] |
getPrototypeOf
|
| [[SetPrototypeOf]] |
setPrototypeOf
|
| [[IsExtensible]] |
isExtensible
|
| [[PreventExtensions]] |
preventExtensions
|
| [[GetOwnProperty]] |
getOwnPropertyDescriptor
|
| [[DefineOwnProperty]] |
defineProperty
|
| [[HasProperty]] |
has
|
| [[Get]] |
get
|
| [[Set]] |
set
|
| [[Delete]] |
deleteProperty
|
| [[OwnPropertyKeys]] |
ownKeys
|
| [[Call]] |
apply
|
| [[Construct]] |
construct
|
ハンドラーメソッドが Proxy オブジェクト内部メソッドの実装として呼び出されるとき、そのハンドラーメソッドにはプロキシのターゲットオブジェクトがパラメータとして渡される。プロキシのハンドラーオブジェクトは必ずしもすべての本質的な内部メソッドに対応するメソッドを持つ必要はない。プロキシ上で内部メソッドが呼ばれた際に、ハンドラーオブジェクトが該当するトラップメソッドを持たない場合は、プロキシのターゲットオブジェクト上の対応する内部メソッドが呼び出される。
Proxy オブジェクトの [[ProxyHandler]] および [[ProxyTarget]]
内部スロットは、オブジェクト生成時に常に初期化され、通常は変更されない。一部の Proxy
オブジェクトは、生成後にrevoke（無効化）できるような方法で作成される。プロキシが無効化されると、その [[ProxyHandler]] および [[ProxyTarget]] 内部スロットは
Proxy オブジェクトは本質的な内部メソッドの実装を任意の ECMAScript コードで提供可能であるため、ハンドラーメソッドが
以下のアルゴリズム記述では、O は ECMAScript Proxy オブジェクト、P は
10.5.1 [[GetPrototypeOf]] ( )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート ：handler はObject である 。- trap を ?
GetMethod (handler,"getPrototypeOf" ) とする。 - もし trap が
undefined なら、- ? target.[[GetPrototypeOf]]() を返す。
- handlerProto を ?
Call (trap, handler, « target » ) とする。 - もし handlerProto が
Object でない かつ handlerProto がnull でない場合、TypeError 例外をスローする。 - extensibleTarget を ?
IsExtensible (target) とする。 - もし extensibleTarget が
true なら、handlerProto を返す。 - targetProto を ? target.[[GetPrototypeOf]]() とする。
- もし
SameValue (handlerProto, targetProto) がfalse なら、TypeError 例外をスローする。 - handlerProto を返す。
Proxy オブジェクトの [[GetPrototypeOf]] は以下の不変条件を強制する：
-
[[GetPrototypeOf]] の結果は Object または
null でなければならない。 - ターゲットオブジェクトが拡張不可能な場合、Proxy オブジェクトに対する [[GetPrototypeOf]] は、ターゲットオブジェクトに対する [[GetPrototypeOf]] と同じ値を返さなければならない。
10.5.2 [[SetPrototypeOf]] ( V )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート ：handler はObject である 。- trap を ?
GetMethod (handler,"setPrototypeOf" ) とする。 - もし trap が
undefined なら、- ? target.[[SetPrototypeOf]](V) を返す。
- booleanTrapResult を
ToBoolean (?Call (trap, handler, « target, V »)) とする。 - もし booleanTrapResult が
false なら、false を返す。 - extensibleTarget を ?
IsExtensible (target) とする。 - もし extensibleTarget が
true なら、true を返す。 - targetProto を ? target.[[GetPrototypeOf]]() とする。
- もし
SameValue (V, targetProto) がfalse なら、TypeError 例外をスローする。 true を返す。
Proxy オブジェクトの [[SetPrototypeOf]] は以下の不変条件を強制する：
-
[[SetPrototypeOf]] の結果は
Boolean 値である。 - ターゲットオブジェクトが拡張不可能な場合、引数の値はターゲットオブジェクトに対する [[GetPrototypeOf]] の結果と同じでなければならない。
10.5.3 [[IsExtensible]] ( )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート ：handler はObject である 。- trap を ?
GetMethod (handler,"isExtensible" ) とする。 - もし trap が
undefined なら、- ?
IsExtensible (target) を返す。
- ?
- booleanTrapResult を
ToBoolean (?Call (trap, handler, « target » )) とする。 - targetResult を ?
IsExtensible (target) とする。 - もし booleanTrapResult が targetResult
と異なる場合、
TypeError 例外をスローする。 - booleanTrapResult を返す。
Proxy オブジェクトの [[IsExtensible]] は以下の不変条件を強制する：
-
[[IsExtensible]] の結果は
Boolean 値である。 - Proxy オブジェクトに対して [[IsExtensible]] を適用した結果は、同じ引数でターゲットオブジェクトに [[IsExtensible]] を適用した結果と同じでなければならない。
10.5.4 [[PreventExtensions]] ( )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート ：handler はObject である 。- trap を ?
GetMethod (handler,"preventExtensions" ) とする。 - もし trap が
undefined なら、- ? target.[[PreventExtensions]]() を返す。
- booleanTrapResult を
ToBoolean (?Call (trap, handler, « target » )) とする。 - もし booleanTrapResult が
true なら、- extensibleTarget を ?
IsExtensible (target) とする。 - もし extensibleTarget が
true なら、TypeError 例外をスローする。
- extensibleTarget を ?
- booleanTrapResult を返す。
Proxy オブジェクトの [[PreventExtensions]] は以下の不変条件を強制する：
-
[[PreventExtensions]] の結果は
Boolean 値である。 -
Proxy オブジェクトに対して [[PreventExtensions]] を適用した結果が
true となるのは、ターゲットオブジェクトに対する [[IsExtensible]] の結果がfalse の場合のみである。
10.5.5 [[GetOwnProperty]] ( P )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート : handler はObject である 。- trap を ?
GetMethod (handler,"getOwnPropertyDescriptor" ) とする。 - もし trap が
undefined なら、- ? target.[[GetOwnProperty]](P) を返す。
- trapResultObj を ?
Call (trap, handler, « target, P » ) とする。 - もし trapResultObj が
Object でない かつ trapResultObj がundefined でない場合、TypeError 例外をスローする。 - targetDesc を ? target.[[GetOwnProperty]](P) とする。
- もし trapResultObj が
undefined なら、- もし targetDesc が
undefined なら、undefined を返す。 - もし targetDesc.[[Configurable]] が
false なら、TypeError 例外をスローする。 - extensibleTarget を ?
IsExtensible (target) とする。 - もし extensibleTarget が
false なら、TypeError 例外をスローする。 undefined を返す。
- もし targetDesc が
- extensibleTarget を ?
IsExtensible (target) とする。 - resultDesc を ?
ToPropertyDescriptor (trapResultObj) とする。 CompletePropertyDescriptor (resultDesc) を実行する。- valid を
IsCompatiblePropertyDescriptor (extensibleTarget, resultDesc, targetDesc) とする。 - もし valid が
false なら、TypeError 例外をスローする。 - もし resultDesc.[[Configurable]] が
false なら、- もし targetDesc が
undefined または targetDesc.[[Configurable]] がtrue なら、TypeError 例外をスローする。
- もし resultDesc が [[Writable]] フィールドを持ち、かつ
resultDesc.[[Writable]] が
false なら、アサート : targetDesc は [[Writable]] フィールドを持つ。- もし targetDesc.[[Writable]] が
true なら、TypeError 例外をスローする。
- もし targetDesc が
- resultDesc を返す。
Proxy オブジェクトの [[GetOwnProperty]] は以下の不変条件を強制する：
-
[[GetOwnProperty]] の結果は Object または
undefined でなければならない。 - ターゲットオブジェクトの non-configurable な own プロパティが存在する場合、そのプロパティは存在しないと報告できない。
- ターゲットオブジェクトに own プロパティが存在し、かつターゲットオブジェクトが拡張不可能な場合、そのプロパティは存在しないと報告できない。
- ターゲットオブジェクトに own プロパティが存在しない、かつターゲットオブジェクトが拡張不可能な場合、そのプロパティは存在すると報告できない。
- non-configurable として報告できるのは、ターゲットオブジェクトの non-configurable な own プロパティが存在する場合のみである。
- non-configurable かつ non-writable として報告できるのは、ターゲットオブジェクトに non-configurable かつ non-writable な own プロパティが存在する場合のみである。
10.5.6 [[DefineOwnProperty]] ( P, Desc )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート : handler はObject である 。- trap を ?
GetMethod (handler,"defineProperty" ) とする。 - もし trap が
undefined なら、- ? target.[[DefineOwnProperty]](P, Desc) を返す。
- descObj を
FromPropertyDescriptor (Desc) とする。 - booleanTrapResult を
ToBoolean (?Call (trap, handler, « target, P, descObj »)) とする。 - もし booleanTrapResult が
false なら、false を返す。 - targetDesc を ? target.[[GetOwnProperty]](P) とする。
- extensibleTarget を ?
IsExtensible (target) とする。 - もし Desc が [[Configurable]] フィールドを持ち、かつ
Desc.[[Configurable]] が
false なら、- settingConfigFalse を
true とする。
- settingConfigFalse を
- それ以外の場合、
- settingConfigFalse を
false とする。
- settingConfigFalse を
- もし targetDesc が
undefined なら、- もし extensibleTarget が
false なら、TypeError 例外をスローする。 - もし settingConfigFalse が
true なら、TypeError 例外をスローする。
- もし extensibleTarget が
- それ以外の場合、
- もし
IsCompatiblePropertyDescriptor (extensibleTarget, Desc, targetDesc) がfalse なら、TypeError 例外をスローする。 - もし settingConfigFalse が
true かつ targetDesc.[[Configurable]] がtrue なら、TypeError 例外をスローする。 - もし
IsDataDescriptor (targetDesc) がtrue かつ targetDesc.[[Configurable]] がfalse かつ targetDesc.[[Writable]] がtrue なら、- もし Desc が [[Writable]] フィールドを持ち、かつ
Desc.[[Writable]] が
false なら、TypeError 例外をスローする。
- もし Desc が [[Writable]] フィールドを持ち、かつ
Desc.[[Writable]] が
- もし
true を返す。
Proxy オブジェクトの [[DefineOwnProperty]] は以下の不変条件を強制する：
-
[[DefineOwnProperty]] の結果は
Boolean 値である。 - ターゲットオブジェクトが拡張不可能な場合、プロパティを追加できない。
- non-configurable にできるのは、対応する non-configurable なターゲットオブジェクトの own プロパティが存在する場合のみ。
- non-configurable かつ non-writable にできるのは、対応する non-configurable かつ non-writable なターゲットオブジェクトの own プロパティが存在する場合のみ。
- プロパティに対応するターゲットオブジェクトのプロパティが存在する場合、そのプロパティディスクリプタをターゲットオブジェクトに [[DefineOwnProperty]] で適用しても例外は発生しない。
10.5.7 [[HasProperty]] ( P )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート : handler はObject である 。- trap を ?
GetMethod (handler,"has" ) とする。 - もし trap が
undefined なら、- ? target.[[HasProperty]](P) を返す。
- booleanTrapResult を
ToBoolean (?Call (trap, handler, « target, P » )) とする。 - もし booleanTrapResult が
false なら、- targetDesc を ? target.[[GetOwnProperty]](P) とする。
- もし targetDesc が
undefined でなければ、- もし targetDesc.[[Configurable]] が
false なら、TypeError 例外をスローする。 - extensibleTarget を ?
IsExtensible (target) とする。 - もし extensibleTarget が
false なら、TypeError 例外をスローする。
- もし targetDesc.[[Configurable]] が
- booleanTrapResult を返す。
Proxy オブジェクトの [[HasProperty]] は以下の不変条件を強制する：
-
[[HasProperty]] の結果は
Boolean 値である。 - ターゲットオブジェクトの non-configurable な own プロパティが存在する場合、そのプロパティは存在しないと報告できない。
- ターゲットオブジェクトに own プロパティが存在し、かつターゲットオブジェクトが拡張不可能な場合、そのプロパティは存在しないと報告できない。
10.5.8 [[Get]] ( P, Receiver )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート : handler はObject である 。- trap を ?
GetMethod (handler,"get" ) とする。 - もし trap が
undefined なら、- ? target.[[Get]](P, Receiver) を返す。
- trapResult を ?
Call (trap, handler, « target, P, Receiver » ) とする。 - targetDesc を ? target.[[GetOwnProperty]](P) とする。
- もし targetDesc が
undefined でなく、かつ targetDesc.[[Configurable]] がfalse なら、- もし
IsDataDescriptor (targetDesc) がtrue かつ targetDesc.[[Writable]] がfalse なら、- もし
SameValue (trapResult, targetDesc.[[Value]]) がfalse なら、TypeError 例外をスローする。
- もし
- もし
IsAccessorDescriptor (targetDesc) がtrue かつ targetDesc.[[Get]] がundefined なら、- もし trapResult が
undefined でない場合、TypeError 例外をスローする。
- もし trapResult が
- もし
- trapResult を返す。
10.5.9 [[Set]] ( P, V, Receiver )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート : handler はObject である 。- trap を ?
GetMethod (handler,"set" ) とする。 - もし trap が
undefined なら、- ? target.[[Set]](P, V, Receiver) を返す。
- booleanTrapResult を
ToBoolean (?Call (trap, handler, « target, P, V, Receiver »)) とする。 - もし booleanTrapResult が
false なら、false を返す。 - targetDesc を ? target.[[GetOwnProperty]](P) とする。
- もし targetDesc が
undefined でなく、 targetDesc.[[Configurable]] がfalse なら、- もし
IsDataDescriptor (targetDesc) がtrue かつ targetDesc.[[Writable]] がfalse なら、SameValue (V, targetDesc.[[Value]]) がfalse なら、TypeError 例外をスローする。
- もし
IsAccessorDescriptor (targetDesc) がtrue なら、- もし targetDesc.[[Set]] が
undefined なら、TypeError 例外をスローする。
- もし targetDesc.[[Set]] が
- もし
true を返す。
10.5.10 [[Delete]] ( P )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート : handler はObject である 。- trap を ?
GetMethod (handler,"deleteProperty" ) とする。 - もし trap が
undefined なら、- ? target.[[Delete]](P) を返す。
- booleanTrapResult を
ToBoolean (?Call (trap, handler, « target, P »)) とする。 - もし booleanTrapResult が
false なら、false を返す。 - targetDesc を ? target.[[GetOwnProperty]](P) とする。
- もし targetDesc が
undefined なら、true を返す。 - もし targetDesc.[[Configurable]] が
false なら、TypeError 例外をスローする。 - extensibleTarget を ?
IsExtensible (target) とする。 - もし extensibleTarget が
false なら、TypeError 例外をスローする。 true を返す。
Proxy オブジェクトの [[Delete]] は次の不変条件を強制する：
-
[[Delete]] の結果は
Boolean 値である。 - 対象プロパティがターゲットオブジェクトの非設定可能 own プロパティである場合、それを削除済みとして報告することはできない。
- 対象プロパティがターゲットオブジェクトの own プロパティであり、ターゲットオブジェクトが拡張不可能な場合、それを削除済みとして報告することはできない。
10.5.11 [[OwnPropertyKeys]] ( )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート : handler はObject である 。- trap を ?
GetMethod (handler,"ownKeys" ) とする。 - もし trap が
undefined なら、- ? target.[[OwnPropertyKeys]]() を返す。
- trapResultArray を ?
Call (trap, handler, « target » ) とする。 - trapResult を ?
CreateListFromArrayLike (trapResultArray,property-key ) とする。 - もし trapResult に重複する要素が含まれていた場合、
TypeError 例外をスローする。 - extensibleTarget を ?
IsExtensible (target) とする。 - targetKeys を ? target.[[OwnPropertyKeys]]() とする。
アサート : targetKeys はリスト （プロパティキー ）である。アサート : targetKeys には重複する要素は含まれていない。- targetConfigurableKeys を新しい空の
リスト とする。 - targetNonconfigurableKeys を新しい空の
リスト とする。 - targetKeys の各要素 key について、
- desc を ? target.[[GetOwnProperty]](key) とする。
- もし desc が
undefined でなく、desc.[[Configurable]] がfalse なら、- key を targetNonconfigurableKeys に追加する。
- それ以外の場合、
- key を targetConfigurableKeys に追加する。
- もし extensibleTarget が
true かつ targetNonconfigurableKeys が空であるなら、- trapResult を返す。
- uncheckedResultKeys を
リスト （要素は trapResult の要素）とする。 - targetNonconfigurableKeys の各要素 key について、
- もし uncheckedResultKeys に key
が含まれなければ、
TypeError 例外をスローする。 - key を uncheckedResultKeys から削除する。
- もし uncheckedResultKeys に key
が含まれなければ、
- もし extensibleTarget が
true なら、trapResult を返す。 - targetConfigurableKeys の各要素 key について、
- もし uncheckedResultKeys に key
が含まれなければ、
TypeError 例外をスローする。 - key を uncheckedResultKeys から削除する。
- もし uncheckedResultKeys に key
が含まれなければ、
- もし uncheckedResultKeys が空でない場合、
TypeError 例外をスローする。 - trapResult を返す。
10.5.12 [[Call]] ( thisArgument, argumentsList )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
- handler を O.[[ProxyHandler]] とする。
アサート : handler はObject である 。- trap を ?
GetMethod (handler,"apply" ) とする。 - もし trap が
undefined なら、- ?
Call (target, thisArgument, argumentsList) を返す。
- ?
- argArray を
CreateArrayFromList (argumentsList) とする。 - ?
Call (trap, handler, « target, thisArgument, argArray » ) を返す。
10.5.13 [[Construct]] ( argumentsList, newTarget )
- ?
ValidateNonRevokedProxy (O) を実行する。 - target を O.[[ProxyTarget]] とする。
アサート :IsConstructor (target) はtrue である。- handler を O.[[ProxyHandler]] とする。
アサート : handler はObject である 。- trap を ?
GetMethod (handler,"construct" ) とする。 - もし trap が
undefined なら、- ?
Construct (target, argumentsList, newTarget) を返す。
- ?
- argArray を
CreateArrayFromList (argumentsList) とする。 - newObj を ?
Call (trap, handler, « target, argArray, newTarget » ) とする。 - もし newObj が
Object でない 場合、TypeError 例外をスローする。 - newObj を返す。
Proxy オブジェクトの [[Construct]] は次の不変条件を強制する：
- [[Construct]] の結果は Object でなければならない。
10.5.14 ValidateNonRevokedProxy ( proxy )
抽象操作 ValidateNonRevokedProxy は、引数 proxy（
- もし proxy.[[ProxyTarget]] が
null なら、TypeError 例外をスローする。 アサート ： proxy.[[ProxyHandler]] はnull ではない。unused を返す。
10.5.15 ProxyCreate ( target, handler )
抽象操作 ProxyCreate は、引数 target（
- もし target が
Object でない 場合、TypeError 例外をスローする。 - もし handler が
Object でない 場合、TypeError 例外をスローする。 - P を
MakeBasicObject (« [[ProxyHandler]], [[ProxyTarget]] ») とする。 - P の本質的な内部メソッド（[[Call]] および [[Construct]] を除く）を、
10.5 で指定された定義に設定する。 - もし
IsCallable (target) がtrue なら、- P.[[Call]] を
10.5.12 で指定されたとおりに設定する。 - もし
IsConstructor (target) がtrue なら、- P.[[Construct]] を
10.5.13 で指定されたとおりに設定する。
- P.[[Construct]] を
- P.[[Call]] を
- P.[[ProxyTarget]] に target を設定する。
- P.[[ProxyHandler]] に handler を設定する。
- P を返す。
11 ECMAScript 言語：ソーステキスト
11.1 ソーステキスト
構文
ECMAScript ソーステキストは、Unicode コードポイントの列である。U+0000 から U+10FFFF までのすべての Unicode
コードポイント値（サロゲートコードポイントを含む）は、ECMAScript 文法で許可される場所で ECMAScript ソーステキスト内に出現できる。ECMAScript
ソーステキストを保存・交換する際に用いられる実際のエンコーディングは本仕様に関係しない。外部ソーステキストのエンコーディングに関わらず、適合 ECMAScript 実装は、ソーステキストを等価な
結合文字列の構成要素は、ユーザーが全体を 1 文字と考える場合でも、個々の Unicode コードポイントとして扱われる。
文字列リテラル、正規表現リテラル、テンプレートリテラル、識別子では、任意の Unicode コードポイントも、その数値値を明示的に表す Unicode エスケープシーケンスで表すことができる。コメント内では、このようなエスケープシーケンスはコメントの一部として事実上無視される。
ECMAScript は、Unicode エスケープシーケンスの振る舞いが Java プログラミング言語と異なる。たとえば Java プログラム内で
\u000A のようなエスケープシーケンスが単一行コメント内に現れると、それは行終端子（Unicode コードポイント U+000A：LINE FEED
(LF)）として解釈され、次のコードポイントはコメントの一部とならない。同様に、Java プログラムの文字列リテラル内で \u000A
が現れると、それも行終端子と解釈され、文字列リテラル内に行終端子を含めることはできない。LINE FEED (LF) を文字列リテラルの値の一部にしたい場合は
\n を使う必要がある。ECMAScript プログラムでは、コメント内の Unicode
エスケープシーケンスは決して解釈されず、コメントの終了に寄与することはない。同様に、ECMAScript プログラム内の文字列リテラル内で発生する Unicode
エスケープシーケンスは常にリテラルの一部となり、行終端子や文字列リテラルの終了となるコードポイントとして解釈されることはない。
11.1.1 静的セマンティクス: UTF16EncodeCodePoint ( cp )
抽象操作 UTF16EncodeCodePoint は、引数 cp（Unicode コードポイント）を取り、文字列を返す。呼び出されたとき、次の手順を実行する：
11.1.2 静的セマンティクス: CodePointsToString ( text )
抽象操作 CodePointsToString は、引数 text（Unicode コードポイント列）を取り、文字列を返す。text を
- result を空文字列とする。
- text の各コードポイント cp について、
- result を result と
UTF16EncodeCodePoint (cp) の文字列連結 に設定する。
- result を result と
- result を返す。
11.1.3 静的セマンティクス: UTF16SurrogatePairToCodePoint ( lead, trail )
抽象操作 UTF16SurrogatePairToCodePoint は、引数
lead（コードユニット）、trail（コードユニット）を取り、コードポイントを返す。UTF-16
アサート : lead はリーディングサロゲート であり、trail はトレーリングサロゲート である。- cp を (lead - 0xD800) × 0x400 + (trail - 0xDC00) + 0x10000 とする。
- コードポイント cp を返す。
11.1.4 静的セマンティクス: CodePointAt ( string, position )
抽象操作 CodePointAt は、引数 string（文字列）、position（非負の
- size を string の長さとする。
アサート : position ≥ 0 かつ position < size。- first を string の position 番目のコードユニットとする。
- cp を first の数値値を持つコードポイントとする。
- もし first が
リーディングサロゲート でもトレーリングサロゲート でもない場合、Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:false } を返す。
- もし first が
トレーリングサロゲート であるか、position + 1 = size なら、Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true } を返す。
- second を string の position + 1 番目のコードユニットとする。
- もし second が
トレーリングサロゲート でない場合、Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true } を返す。
- cp を
UTF16SurrogatePairToCodePoint (first, second) に設定する。 Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 2, [[IsUnpairedSurrogate]]:false } を返す。
11.1.5 静的セマンティクス: StringToCodePoints ( string )
抽象操作 StringToCodePoints は、引数 string（文字列）を取り、
- codePoints を新しい空の
リスト とする。 - size を string の長さとする。
- position を 0 とする。
- position < size の間、繰り返す：
- cp を
CodePointAt (string, position) に設定する。 - cp.[[CodePoint]] を codePoints に追加する。
- position を position + cp.[[CodeUnitCount]] に設定する。
- cp を
- codePoints を返す。
11.1.6 静的セマンティクス: ParseText ( sourceText, goalSymbol )
抽象操作 ParseText は、引数 sourceText（文字列または Unicode
コードポイント列）、goalSymbol（ECMAScript 文法の非終端記号）を取り、
- もし sourceText が
文字列 なら、sourceText をStringToCodePoints (sourceText) に設定する。 - sourceText を goalSymbol を
ゴール記号 として用いて構文解析し、パース結果についてearly error 条件を解析する。構文解析およびearly error 検出は、実装定義 の方法でインタリーブされてもよい。 - 構文解析が成功し、
early errors が見つからなかった場合、パースツリーのルートであるParse Node （goalSymbol のインスタンス）を返す。 - それ以外の場合、解析エラーおよび/または
early errors を表す 1 つ以上のSyntaxError オブジェクトのリスト を返す。複数の解析エラーまたはearly error がある場合、そのリスト内のエラーオブジェクトの数や順序は実装定義 だが、少なくとも 1 つは存在しなければならない。
あるテキストに特定の場所で
詳細は
11.2 ソースコードの種類
ECMAScript コードには4つの種類がある：
-
グローバルコードは、ECMAScript の
Script として扱われるソーステキストである。特定のScript のグローバルコードには、FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 、またはClassExpression の一部として構文解析されるソーステキストは含まれない。 -
eval コードは、組み込みの
eval関数に渡されたソーステキストである。より正確には、組み込みのeval関数のパラメータがString である 場合、それは ECMAScript のScript として扱われる。evalのある呼び出しの eval コードは、そのScript のグローバルコード部分である。 -
関数コードは、ECMAScript の
関数オブジェクト の [[ECMAScriptCode]] および [[FormalParameters]] 内部スロット（10.2 参照）に値を与えるために構文解析されるソーステキストである。特定の ECMAScript 関数の関数コードには、入れ子になったFunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 、またはClassExpression の関数コードとして構文解析されるソーステキストは含まれない。さらに、上記のソーステキストが次のように構文解析される場合：
FormalParameters およびFunctionBody がFunctionDeclaration またはFunctionExpression の場合、FormalParameters およびGeneratorBody がGeneratorDeclaration またはGeneratorExpression の場合、FormalParameters およびAsyncFunctionBody がAsyncFunctionDeclaration またはAsyncFunctionExpression の場合、FormalParameters およびAsyncGeneratorBody がAsyncGeneratorDeclaration またはAsyncGeneratorExpression の場合、
その場合、宣言または式の
BindingIdentifier （存在する場合）によってマッチされるソーステキスト も、その関数の関数コードに含まれる。 -
モジュールコードは、
ModuleBody として提供されるコードである。これは、モジュールが初期化されるときに直接評価されるコードである。特定のモジュールのモジュールコードには、入れ子になったFunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 、またはClassExpression の一部として構文解析されるソーステキストは含まれない。
関数コードは通常、関数定義（
関数コードに
11.2.1 ディレクティブプロローグと use strict ディレクティブ
ディレクティブプロローグとは、
use strict
ディレクティブとは、"use strict" または 'use strict' というコードポイント列であるものである。
11.2.2 厳格モードコード
ECMAScript の構文単位は、無制限モードまたは厳格モードの構文と意味（
-
グローバルコード が、ディレクティブプロローグ の先頭にuse strict ディレクティブ を含む場合。 -
モジュールコード は常に厳格モードコードである。 -
すべての
ClassDeclaration またはClassExpression の部分は厳格モードコードである。 -
eval コード が、ディレクティブプロローグ の先頭にuse strict ディレクティブ を含む場合、またはevalへの呼び出しがdirect eval であり、その呼び出し元が厳格モードコードである場合。 -
関数コード の関連するFunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、またはAsyncArrowFunction が厳格モードコード内に含まれている場合、または関数の [[ECMAScriptCode]] 内部スロットの値を生成するコードの先頭にディレクティブプロローグ があり、そこにuse strict ディレクティブ を含む場合。 -
組み込みの Function、Generator、AsyncFunction、AsyncGenerator
constructor に引数として渡される関数コード は、最後の引数がString であり 、それが処理されたときFunctionBody の先頭にディレクティブプロローグ があり、そこにuse strict ディレクティブ を含む場合は厳格モードコードである。
厳格モードコードでない ECMAScript コードは、非厳格コード と呼ばれる。
11.2.2.1 静的セマンティクス: IsStrict ( node )
抽象操作 IsStrict は、引数 node（
- もし
node にマッチしたソーステキスト が厳格モードコード であればtrue を返し、そうでなければfalse を返す。
11.2.3 非ECMAScript関数
ECMAScript の実装は、評価動作が
12 ECMAScript言語：字句文法
ECMAScriptの
字句入力要素の識別は、それを消費する構文文法コンテキストによって影響を受ける場合があります。これには、字句文法に対して複数の
複数の字句ゴールを用いることで、自動セミコロン挿入に影響する字句の曖昧さが生じないことが保証されます。例えば、先頭に除算または除算代入、および先頭に
a = b
/hi/g.exec(c).map(d);a = b / hi / g.exec(c).map(d);構文
12.1 Unicode書式制御文字
Unicode書式制御文字（つまりUnicode Character Databaseの「Cf」カテゴリに属する文字、例えばLEFT-TO-RIGHT MARKやRIGHT-TO-LEFT MARKなど）は、より高次のプロトコル（マークアップ言語など）が存在しない場合に、テキスト範囲の書式を制御するために使用される制御コードです。
編集や表示を容易にするために、ソーステキスト内で書式制御文字を許可することは有用です。すべての書式制御文字は、コメント内、文字列リテラル、テンプレートリテラル、正規表現リテラル内で使用できます。
U+FEFF（ZERO WIDTH NO-BREAK
SPACE）は、主にテキストの先頭でUnicodeであることやテキストの符号化・バイト順序を識別するために使われる書式制御文字です。この目的で意図された<ZWNBSP>文字は、ファイルの連結などの結果としてテキストの先頭以外にも現れることがあります。
12.2 空白
空白コードポイントは、ソーステキストの可読性を高めたり、トークン（不可分な字句単位）同士を区切るために使われますが、それ以外では意味を持ちません。空白コードポイントは、任意の2つのトークンの間や入力の先頭・末尾に出現できます。空白コードポイントは、
ECMAScriptでの空白コードポイントは、
| コードポイント | 名称 | 略号 |
|---|---|---|
U+0009
|
CHARACTER TABULATION | <TAB> |
U+000B
|
LINE TABULATION | <VT> |
U+000C
|
FORM FEED (FF) | <FF> |
U+FEFF
|
ZERO WIDTH NO-BREAK SPACE | <ZWNBSP> |
| 一般カテゴリ「Space_Separator」に属する任意のコードポイント | <USP> |
U+0020（SPACE）およびU+00A0（NO-BREAK SPACE）は<USP>に含まれます。
構文
12.3 行終端子
空白コードポイントと同様に、行終端子コードポイントもソーステキストの可読性を高めたり、トークン（不可分な字句単位）同士を区切るために使われます。ただし空白コードポイントと異なり、行終端子は構文文法の挙動に影響を与える場合があります。一般には、行終端子は任意の2つのトークンの間に現れることができますが、構文文法によって禁止されている箇所もあります。また、行終端子は自動セミコロン挿入の処理（
行終端子は
行終端子は、正規表現の\sクラスでマッチする空白コードポイントの集合に含まれます。
ECMAScriptでの行終端子コードポイントは、
| コードポイント | Unicode名称 | 略号 |
|---|---|---|
U+000A
|
LINE FEED (LF) | <LF> |
U+000D
|
CARRIAGE RETURN (CR) | <CR> |
U+2028
|
LINE SEPARATOR | <LS> |
U+2029
|
PARAGRAPH SEPARATOR | <PS> |
構文
12.4 コメント
コメントは、単一行または複数行のいずれかです。複数行コメントはネストできません。
単一行コメントは、//マーカーから行末までのすべてのコードポイントで構成されます。ただし、行末の
コメントは空白のように扱われ、破棄されますが、
構文
このセクションのいくつかの生成規則は、
12.5 ハッシュバンコメント
ハッシュバンコメントは位置依存であり、他の種類のコメントと同様に、構文文法の入力要素ストリームから破棄されます。
構文
12.6 トークン
構文
12.7 名前とキーワード
この標準は、特定のコードポイントの追加を指定しています：U+0024（DOLLAR SIGN）およびU+005F（LOW LINE）は、
構文
非終端記号
非終端記号_を導出します。
Unicodeプロパティ「ID_Start」および「ID_Continue」を持つコードポイントの集合には、それぞれ「Other_ID_Start」および「Other_ID_Continue」を持つコードポイントも含まれます。
12.7.1 識別子名
Unicodeエスケープシーケンスは、\は、いかなるコードポイントにも寄与しません。\
Unicode標準により正規等価と見なされる2つの
12.7.1.1 静的セマンティクス: 早期エラー
-
IdentifierCodePoint がUnicodeEscapeSequence のUnicodeコードポイントであり、かつそれがIdentifierStartChar 字句文法生成規則にマッチしない場合は構文エラーです。
-
IdentifierCodePoint がUnicodeEscapeSequence のUnicodeコードポイントであり、かつそれがIdentifierPartChar 字句文法生成規則にマッチしない場合は構文エラーです。
12.7.1.2 静的セマンティクス: IdentifierCodePoints
- cpを、
IdentifierCodePoint （IdentifierStart のもの）とする。 - « cp »を返す。
- cpsを、派生した
IdentifierName のIdentifierCodePoints とする。 - cpを、
IdentifierPart のIdentifierCodePoint とする。 - cpsと« cp »の
リスト結合 を返す。
12.7.1.3 静的セマンティクス: IdentifierCodePoint
IdentifierStartChar にマッチしたコードポイントを返す。
IdentifierPartChar にマッチしたコードポイントを返す。
Hex4Digits のMV（数値値）を持つコードポイントを返す。
CodePoint のMV（数値値）を持つコードポイントを返す。
12.7.2 キーワードと予約語
キーワードとは、fixed widthフォント）として現れます。ECMAScriptのキーワードにはif、while、async、awaitなど多数があります。
予約語とは、識別子として使用できないifやwhileは予約語です。awaitはasync関数やモジュール内でのみ予約されます。asyncは予約語ではなく、変数名やラベルとして制限なく使用できます。
この仕様は、どの名前が有効な識別子であり、どれが予約語であるかを指定するために、文法生成規則とawaitとyieldを除き、無条件で予約されます。awaitとyieldの例外は、パラメータ化された構文生成規則を用いて
-
常に識別子として許可され、かつキーワードでないもの（例：
Math、window、toString、_など） -
決して識別子として許可されないもの、すなわち
awaitとyieldを除く下記のReservedWord たち -
文脈によって識別子として許可されるもの、すなわち
awaitとyield -
strict mode code において文脈によって識別子として許可されないもの：let、static、implements、interface、package、private、protected、public -
常に識別子として許可されるが、特定の構文生成規則内ではキーワードとして現れるもの（
Identifier が許可されない箇所）：as、async、from、get、meta、of、set、target
条件付きキーワードまたは文脈キーワードという用語は、最後の3つのカテゴリに該当するキーワードを指し、それゆえ、ある文脈では識別子として、別の文脈ではキーワードとして使われることができます。
構文
\
\els\u{65}のようにスペルして"else"という変数を宣言することはできません。
enumは現時点ではこの仕様でキーワードとして使われていません。これは将来の予約語であり、将来の言語拡張でキーワードとして使われるために確保されています。
同様に、implements、interface、package、private、protected、publicは、
12.8 区切り記号
構文
12.9 リテラル
12.9.1 Nullリテラル
構文
12.9.2 真偽値リテラル
構文
12.9.3 数値リテラル
構文
例えば：3inはエラーであり、入力要素3とinの2つではない。
12.9.3.1 静的セマンティクス: 早期エラー
IsStrict (この生成規則)がtrue の場合、構文エラーとなる。
12.9.3.2 静的セマンティクス: MV
数値リテラルは、
-
DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits DecimalIntegerLiteral のMVに (DecimalDigits のMV × 10-n) を加算したものである。ただし、nはDecimalDigits のコードポイント数（すべてのNumericLiteralSeparator の出現を除く）である。 -
DecimalLiteral :: DecimalIntegerLiteral . ExponentPart DecimalIntegerLiteral のMV × 10e である。eはExponentPart のMVである。 -
DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits ExponentPart DecimalIntegerLiteral のMV + (DecimalDigits のMV × 10-n)) × 10e である。ここでnはDecimalDigits のコードポイント数（すべてのNumericLiteralSeparator の出現を除く）、eはExponentPart のMVである。 -
DecimalLiteral :: . DecimalDigits DecimalDigits のMV × 10-nである。ここでnはDecimalDigits のコードポイント数（すべてのNumericLiteralSeparator の出現を除く）である。 -
DecimalLiteral :: . DecimalDigits ExponentPart DecimalDigits のMV × 10e - nである。ここでnはDecimalDigits のコードポイント数（すべてのNumericLiteralSeparator の出現を除く）、eはExponentPart のMVである。 -
DecimalLiteral :: DecimalIntegerLiteral ExponentPart DecimalIntegerLiteral のMV × 10eである。eはExponentPart のMVである。 -
DecimalIntegerLiteral :: 0 -
DecimalIntegerLiteral :: NonZeroDigit NumericLiteralSeparator opt DecimalDigits NonZeroDigit のMV × 10n) +DecimalDigits のMV である。ここでnはDecimalDigits のコードポイント数（すべてのNumericLiteralSeparator の出現を除く）である。 -
DecimalDigits :: DecimalDigits DecimalDigit DecimalDigits のMV × 10) +DecimalDigit のMVである。 -
DecimalDigits :: DecimalDigits NumericLiteralSeparator DecimalDigit DecimalDigits のMV × 10) +DecimalDigit のMVである。 -
ExponentPart :: ExponentIndicator SignedInteger SignedInteger のMVである。 -
SignedInteger :: - DecimalDigits DecimalDigits のMVの負である。 -
DecimalDigit :: 0 HexDigit :: 0 OctalDigit :: 0 LegacyOctalEscapeSequence :: 0 BinaryDigit :: 0 -
DecimalDigit :: 1 NonZeroDigit :: 1 HexDigit :: 1 OctalDigit :: 1 BinaryDigit :: 1 -
DecimalDigit :: 2 NonZeroDigit :: 2 HexDigit :: 2 OctalDigit :: 2 -
DecimalDigit :: 3 NonZeroDigit :: 3 HexDigit :: 3 OctalDigit :: 3 -
DecimalDigit :: 4 NonZeroDigit :: 4 HexDigit :: 4 OctalDigit :: 4 -
DecimalDigit :: 5 NonZeroDigit :: 5 HexDigit :: 5 OctalDigit :: 5 -
DecimalDigit :: 6 NonZeroDigit :: 6 HexDigit :: 6 OctalDigit :: 6 -
DecimalDigit :: 7 NonZeroDigit :: 7 HexDigit :: 7 OctalDigit :: 7 -
DecimalDigit :: 8 NonZeroDigit :: 8 NonOctalDigit :: 8 HexDigit :: 8 -
DecimalDigit :: 9 NonZeroDigit :: 9 NonOctalDigit :: 9 HexDigit :: 9 -
HexDigit :: a HexDigit :: A -
HexDigit :: b HexDigit :: B -
HexDigit :: c HexDigit :: C -
HexDigit :: d HexDigit :: D -
HexDigit :: e HexDigit :: E -
HexDigit :: f HexDigit :: F -
BinaryDigits :: BinaryDigits BinaryDigit BinaryDigits のMV × 2)にBinaryDigit のMVを加えた値である。 -
BinaryDigits :: BinaryDigits NumericLiteralSeparator BinaryDigit BinaryDigits のMV × 2)にBinaryDigit のMVを加えた値である。 -
OctalDigits :: OctalDigits OctalDigit OctalDigits のMV × 8)にOctalDigit のMVを加えた値である。 -
OctalDigits :: OctalDigits NumericLiteralSeparator OctalDigit OctalDigits のMV × 8)にOctalDigit のMVを加えた値である。 -
LegacyOctalIntegerLiteral :: LegacyOctalIntegerLiteral OctalDigit LegacyOctalIntegerLiteral のMV × 8)にOctalDigit のMVを加えた値である。 -
NonOctalDecimalIntegerLiteral :: LegacyOctalLikeDecimalIntegerLiteral NonOctalDigit LegacyOctalLikeDecimalIntegerLiteral のMV × 10)にNonOctalDigit のMVを加えた値である。 -
NonOctalDecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral DecimalDigit NonOctalDecimalIntegerLiteral のMV × 10)にDecimalDigit のMVを加えた値である。 -
LegacyOctalLikeDecimalIntegerLiteral :: LegacyOctalLikeDecimalIntegerLiteral OctalDigit LegacyOctalLikeDecimalIntegerLiteral のMV × 10)にOctalDigit のMVを加えた値である。 -
HexDigits :: HexDigits HexDigit HexDigits のMV × 16)にHexDigit のMVを加えた値である。 -
HexDigits :: HexDigits NumericLiteralSeparator HexDigit HexDigits のMV × 16)にHexDigit のMVを加えた値である。
12.9.3.3 静的セマンティクス: NumericValue
-
RoundMVResult (DecimalLiteral のMV) を返す。
-
𝔽 (NonDecimalIntegerLiteral のMV) を返す。
-
𝔽 (LegacyOctalIntegerLiteral のMV) を返す。
-
BigInt value for (NonDecimalIntegerLiteral のMV) を返す。
-
0 ℤ を返す。
-
BigInt value for (NonZeroDigit のMV) を返す。
-
n を、
DecimalDigits 中の符号位置数（ただし、全てのNumericLiteralSeparator の出現を除外する）とする。 -
mv を (
NonZeroDigit のMV × 10n) にDecimalDigits のMVを加えた値とする。 -
ℤ (mv) を返す。
12.9.4 文字列リテラル
文字列リテラルは、1つまたは2つの引用符で囲まれた0個以上のUnicode符号位置である。Unicode符号位置はエスケープシーケンスによっても表現できる。すべての符号位置は、閉じ引用符、U+005C（REVERSE
SOLIDUS）、U+000D（CARRIAGE RETURN）、U+000A（LINE
FEED）を除き、文字列リテラル内でリテラルとして現れることができる。どの符号位置もエスケープシーケンスの形で現れることができる。文字列リテラルはECMAScriptのString値として評価される。これらのString値を生成する際、Unicodeの符号位置は
構文
非終端記号
<LF>と<CR>は、\nや\u000Aのようなエスケープシーケンスを使うことである。
12.9.4.1 静的セマンティクス: 早期エラー
- この生成規則に対し
IsStrict がtrue の場合、構文エラーとなる。
文字列リテラルが
function invalid() { "\7"; "use strict"; }12.9.4.2 静的セマンティクス: SV
文字列リテラルは
-
StringLiteral :: " " -
StringLiteral :: ' ' -
DoubleStringCharacters :: DoubleStringCharacter DoubleStringCharacters DoubleStringCharacter のSVとDoubleStringCharacters のSVを文字列連結 したものである。 -
SingleStringCharacters :: SingleStringCharacter SingleStringCharacters SingleStringCharacter のSVとSingleStringCharacters のSVを文字列連結 したものである。 -
DoubleStringCharacter :: SourceCharacter but not one of " or\ orLineTerminator SourceCharacter で一致した符号位置にUTF16EncodeCodePoint を適用した結果である。 -
DoubleStringCharacter :: <LS> -
DoubleStringCharacter :: <PS> -
DoubleStringCharacter :: LineContinuation -
SingleStringCharacter :: SourceCharacter but not one of ' or\ orLineTerminator SourceCharacter で一致した符号位置にUTF16EncodeCodePoint を適用した結果である。 -
SingleStringCharacter :: <LS> -
SingleStringCharacter :: <PS> -
SingleStringCharacter :: LineContinuation -
EscapeSequence :: 0 -
CharacterEscapeSequence :: SingleEscapeCharacter SingleEscapeCharacter によって決定される数値値を持つコードユニットからなるString値であり、その対応は表37 による。
| エスケープシーケンス | コードユニット値 | Unicode文字名 | 記号 |
|---|---|---|---|
\b
|
0x0008
|
バックスペース | <BS> |
\t
|
0x0009
|
水平タブ | <HT> |
\n
|
0x000A
|
ラインフィード（LF） | <LF> |
\v
|
0x000B
|
垂直タブ | <VT> |
\f
|
0x000C
|
フォームフィード（FF） | <FF> |
\r
|
0x000D
|
キャリッジリターン（CR） | <CR> |
\"
|
0x0022
|
引用符（ダブルクォート） |
"
|
\'
|
0x0027
|
アポストロフィ |
'
|
\\
|
0x005C
|
リバースソリダス |
\
|
-
NonEscapeCharacter :: SourceCharacter but not one of EscapeCharacter またはLineTerminator SourceCharacter で一致した符号位置にUTF16EncodeCodePoint を適用した結果である。 -
EscapeSequence :: LegacyOctalEscapeSequence LegacyOctalEscapeSequence のMVを値とするコードユニットからなるString値である。 -
NonOctalDecimalEscapeSequence :: 8 -
NonOctalDecimalEscapeSequence :: 9 -
HexEscapeSequence :: x HexDigit HexDigit HexEscapeSequence のMVを値とするコードユニットからなるString値である。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit Hex4Digits のMVを値とするコードユニットからなるString値である。 -
UnicodeEscapeSequence :: u{ CodePoint } CodePoint のMVにUTF16EncodeCodePoint を適用した結果である。 -
TemplateEscapeSequence :: 0
12.9.4.3 静的セマンティクス: MV
-
LegacyOctalEscapeSequence :: ZeroToThree OctalDigit ZeroToThree のMV) にOctalDigit のMVを加えた値である。 -
LegacyOctalEscapeSequence :: FourToSeven OctalDigit FourToSeven のMV) にOctalDigit のMVを加えた値である。 -
LegacyOctalEscapeSequence :: ZeroToThree OctalDigit OctalDigit ZeroToThree のMV) に、(8 × 1つ目のOctalDigit のMV)を加え、その後2つ目のOctalDigit のMVを加えた値である。 -
ZeroToThree :: 0 -
ZeroToThree :: 1 -
ZeroToThree :: 2 -
ZeroToThree :: 3 -
FourToSeven :: 4 -
FourToSeven :: 5 -
FourToSeven :: 6 -
FourToSeven :: 7 -
HexEscapeSequence :: x HexDigit HexDigit HexDigit のMV) に2つ目のHexDigit のMVを加えた値である。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit HexDigit のMV) に、(0x100 × 2つ目のHexDigit のMV)を加え、(0x10 × 3つ目のHexDigit のMV)を加え、4つ目のHexDigit のMVを加えた値である。
12.9.5 正規表現リテラル
以下の生成規則は、正規表現リテラルの構文を表現しており、入力要素スキャナーによって正規表現リテラルの終端を検出するために使用される。
実装は
構文
正規表現リテラルは空にすることはできない。空の正規表現リテラルの代わりに、コードユニット列 //
は単一行コメントの開始になる。空の正規表現を指定したい場合は /(?:)/ を使用すること。
12.9.5.1 静的セマンティクス: BodyText
-
RegularExpressionBody として認識されたソーステキストを返す。
12.9.5.2 静的セマンティクス: FlagText
-
RegularExpressionFlags として認識されたソーステキストを返す。
12.9.6 テンプレートリテラルの字句要素
構文
12.9.6.1 静的セマンティクス: TV
-
NoSubstitutionTemplate :: ` ` -
TemplateHead :: ` ${ -
TemplateMiddle :: } ${ -
TemplateTail :: } ` -
TemplateCharacters :: TemplateCharacter TemplateCharacters TemplateCharacter の TV がundefined であるか、TemplateCharacters の TV がundefined である場合、undefined となる。そうでなければ、その TV はstring-concatenation によりTemplateCharacter の TV とTemplateCharacters の TV を連結したものである。 -
TemplateCharacter :: SourceCharacter ただし ` 、\ 、$ 、またはLineTerminator のいずれでもないSourceCharacter でマッチしたコードポイントに対してUTF16EncodeCodePoint を実行した結果である。 -
TemplateCharacter :: $ -
TemplateCharacter :: \ TemplateEscapeSequence SV のTemplateEscapeSequence である。 -
TemplateCharacter :: \ NotEscapeSequence undefined である。 -
TemplateCharacter :: LineTerminatorSequence TRV のLineTerminatorSequence である。 -
LineContinuation :: \ LineTerminatorSequence
12.9.6.2 静的セマンティクス: TRV
-
NoSubstitutionTemplate :: ` ` -
TemplateHead :: ` ${ -
TemplateMiddle :: } ${ -
TemplateTail :: } ` -
TemplateCharacters :: TemplateCharacter TemplateCharacters TemplateCharacter の TRV とTemplateCharacters の TRV をstring-concatenation したものである。 -
TemplateCharacter :: SourceCharacter ただし ` 、\ 、$ 、またはLineTerminator のいずれでもないSourceCharacter で一致したコードポイントにUTF16EncodeCodePoint を実行した結果である。 -
TemplateCharacter :: $ -
TemplateCharacter :: \ TemplateEscapeSequence TemplateEscapeSequence の TRV をstring-concatenation したものである。 -
TemplateCharacter :: \ NotEscapeSequence NotEscapeSequence の TRV をstring-concatenation したものである。 -
TemplateEscapeSequence :: 0 -
NotEscapeSequence :: 0 DecimalDigit DecimalDigit の TRV をstring-concatenation したものである。 -
NotEscapeSequence :: x [先読み ∉ HexDigit ] -
NotEscapeSequence :: x HexDigit [先読み ∉ HexDigit ]HexDigit の TRV をstring-concatenation したものである。 -
NotEscapeSequence :: u [先読み ∉ HexDigit ][先読み ≠ { ] -
NotEscapeSequence :: u HexDigit [先読み ∉ HexDigit ]HexDigit の TRV をstring-concatenation したものである。 -
NotEscapeSequence :: u HexDigit HexDigit [先読み ∉ HexDigit ]HexDigit の TRV、および 2 番目のHexDigit の TRV をstring-concatenation したものである。 -
NotEscapeSequence :: u HexDigit HexDigit HexDigit [先読み ∉ HexDigit ]HexDigit の TRV、2 番目のHexDigit の TRV、および 3 番目のHexDigit の TRV をstring-concatenation したものである。 -
NotEscapeSequence :: u { [先読み ∉ HexDigit ]string-concatenation したものである。 -
NotEscapeSequence :: u { NotCodePoint [先読み ∉ HexDigit ]NotCodePoint の TRV をstring-concatenation したものである。 -
NotEscapeSequence :: u { CodePoint [先読み ∉ HexDigit ][先読み ≠ } ]CodePoint の TRV をstring-concatenation したものである。 -
DecimalDigit :: one of 0 1 2 3 4 5 6 7 8 9 UTF16EncodeCodePoint を実行した結果である。 -
CharacterEscapeSequence :: NonEscapeCharacter SV のNonEscapeCharacter である。 -
SingleEscapeCharacter :: one of ' " \ b f n r t v UTF16EncodeCodePoint を実行した結果である。 -
HexEscapeSequence :: x HexDigit HexDigit HexDigit の TRV、および 2 番目のHexDigit の TRV をstring-concatenation したものである。 -
UnicodeEscapeSequence :: u Hex4Digits Hex4Digits の TRV をstring-concatenation したものである。 -
UnicodeEscapeSequence :: u{ CodePoint } CodePoint の TRV、コード単位 0x007D（RIGHT CURLY BRACKET）をstring-concatenation したものである。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit HexDigit の TRV、2 番目のHexDigit の TRV、3 番目のHexDigit の TRV、4 番目のHexDigit の TRV をstring-concatenation したものである。 -
HexDigits :: HexDigits HexDigit HexDigits の TRV とHexDigit の TRV をstring-concatenation したものである。 -
HexDigit :: one of 0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F UTF16EncodeCodePoint を実行した結果である。 -
LineContinuation :: \ LineTerminatorSequence LineTerminatorSequence の TRV の文字列連結 である。 -
LineTerminatorSequence :: <LF> -
LineTerminatorSequence :: <CR> -
LineTerminatorSequence :: <LS> -
LineTerminatorSequence :: <PS> -
LineTerminatorSequence :: <CR> <LF>
12.10 自動セミコロン挿入
ほとんどの ECMAScript 文および宣言はセミコロンで終わらなければならない。こうしたセミコロンはソーステキストに明示的に記述することが常にできる。しかし利便性のため、特定の場合にはソーステキストからこうしたセミコロンを省略できる。これらの場合は、その場面でセミコロンがソースコードのトークンストリームに自動的に挿入されると説明される。
12.10.1 自動セミコロン挿入の規則
以下の規則において、「トークン」は、
セミコロン挿入には3つの基本規則がある：
-
左から右にソーステキストを構文解析しているとき、文法のいかなる生成規則にも許されていないトークン（問題のあるトークン）が現れた場合、以下のいずれかが真であれば、その問題のあるトークンの直前にセミコロンが自動的に挿入される：
-
問題のあるトークンが、直前のトークンと少なくとも1つの
LineTerminator で区切られている場合。 -
問題のあるトークンが
}である場合。 -
直前のトークンが
)であり、挿入されたセミコロンが do-while 文の終端セミコロンとして構文解析される場合（14.7.2 ）。
-
問題のあるトークンが、直前のトークンと少なくとも1つの
- 左から右にソーステキストを構文解析しているとき、トークンストリームの終端に達し、パーサーが入力トークンストリームをゴール非終端記号の単一インスタンスとして構文解析できない場合、入力ストリームの末尾にセミコロンが自動的に挿入される。
-
左から右にソーステキストを構文解析しているとき、文法のいずれかの生成規則で許可されているトークンが現れたが、その生成規則が制限付き生成規則であり、トークンがその制限付き生成規則内の「[no
LineTerminator here]」注釈の直後に来る終端記号や非終端記号の最初のトークン（したがってそのトークンは制限付きトークンと呼ばれる）であり、制限付きトークンが直前のトークンと少なくとも1つのLineTerminator で区切られている場合、その制限付きトークンの直前にセミコロンが自動的に挿入される。
ただし、上記規則には追加の優先条件がある：自動的に挿入されたセミコロンが空文として構文解析される場合や、そのセミコロンが for
文のヘッダ内の2つのセミコロンのうちの1つになる場合（
以下は文法における唯一の制限付き生成規則である：
これらの制限付き生成規則の実質的な効果は次のとおりである：
-
パーサーが後置演算子として
++または--トークンを解釈する箇所で、その直前のトークンと++または--トークンの間に少なくとも1つのLineTerminator が現れた場合、++または--トークンの直前にセミコロンが自動的に挿入される。 -
continue、break、return、throw、yieldトークンが現れ、その次のトークンの前にLineTerminator が現れる場合、continue、break、return、throw、yieldトークンの直後にセミコロンが自動的に挿入される。 -
アロー関数のパラメータの後に
LineTerminator があり、=>トークンの前に来る場合、セミコロンが自動的に挿入され、その句読点は構文エラーとなる。 -
asyncトークンの後にLineTerminator があり、その後にfunctionまたはIdentifierName または(トークンが続く場合、セミコロンが自動的に挿入され、asyncトークンは続くトークンと同じ式やクラス要素の一部とはみなされない。 -
asyncトークンの後にLineTerminator があり、その後に*トークンが続く場合、セミコロンが自動的に挿入され、その句読点は構文エラーとなる。
このことから ECMAScript プログラマへの実践的な助言は次のとおりである：
-
後置
++や--演算子は被演算子と同じ行に書くこと。 -
returnやthrow文のExpression 、yield式のAssignmentExpression は、return、throw、yieldトークンと同じ行に開始すること。 -
breakやcontinue文のLabelIdentifier は、それぞれのトークンと同じ行に書くこと。 -
アロー関数のパラメータ終端と
=>は同じ行に書くこと。 -
非同期関数やメソッドの前の
asyncトークンは、直後のトークンと同じ行に書くこと。
12.10.2 自動セミコロン挿入の例
この節は規範的ではない。次のソース
{ 1 2 } 3は、自動セミコロン挿入規則があっても ECMAScript 文法上有効な文ではない。対照的に、次のソース
{ 1
2 } 3も ECMAScript 文としては有効ではないが、自動セミコロン挿入によって次のように変換される：
{ 1
;2 ;} 3;これは ECMAScript 文として有効である。
次のソース
for (a; b
)は ECMAScript 文として有効ではなく、自動セミコロン挿入でも変化しない。なぜなら for 文のヘッダのセミコロンが必要だからである。自動セミコロン挿入は
for 文のヘッダ内の2つのセミコロンのいずれかを決して挿入しない。
次のソース
return
a + bは自動セミコロン挿入によって次のように変換される：
return;
a + b;式 a + b は return 文の戻り値として扱われない。なぜなら return
トークンとそれを区切っているからである。
次のソース
a = b
++cは自動セミコロン挿入によって次のように変換される：
a = b;
++c;トークン ++ は変数 b への後置演算子として扱われない。なぜなら b と
++ の間にあるからである。
次のソース
if (a > b)
else c = dは ECMAScript 文として有効ではなく、else
トークンの前で自動セミコロン挿入によって変更されることもない。なぜなら、その時点で文法のいかなる生成規則も適用できないが、自動的に挿入されたセミコロンが空文として構文解析されるためである。
次のソース
a = b + c
(d + e).print()は自動セミコロン挿入によって変換されない。なぜなら2行目の括弧で始まる式が、関数呼び出しの引数リストとみなされるからである：
a = b + c(d + e).print()代入文が左括弧で始まる場合、先行する文の末尾には自動セミコロン挿入に頼らず、明示的にセミコロンを記述するのがよい。
12.10.3 自動セミコロン挿入の興味深いケース
この節は規範的ではない。ECMAScript プログラムは自動セミコロン挿入に頼ることで、非常に少ないセミコロンで記述できる。上述のとおり、セミコロンはすべての改行で挿入されるわけではなく、自動セミコロン挿入は複数のトークンや行終端子を跨いで作用することがある。
ECMAScript に新しい構文機能が追加されると、自動セミコロン挿入の前に構文規則が変わるような追加の文法生成規則が加わる可能性がある。
この節の目的上、自動セミコロン挿入のケースが「興味深い」と見なされるのは、直前のソーステキストによってセミコロンが挿入されるかどうかが変わる場所である。この節の残りでは、この ECMAScript バージョンにおける自動セミコロン挿入の興味深いケースをいくつか説明する。
12.10.3.1 文リストにおける自動セミコロン挿入の興味深いケース
- 開き括弧（
(）。セミコロンがない場合、2行を合わせてCallExpression として解釈される。 - 開き角括弧（
[）。セミコロンがない場合、2行を合わせてプロパティアクセスとみなされ、ArrayLiteral やArrayAssignmentPattern とは解釈されない。 - テンプレートリテラル（
`）。セミコロンがない場合、2行を合わせてタグ付きテンプレート（13.3.11 ）として解釈され、前の式がMemberExpression となる。 - 単項
+または-。セミコロンがない場合、2行を合わせて対応する二項演算子の使用と解釈される。 - 正規表現リテラル。セミコロンがない場合、2行を合わせて
/MultiplicativeOperator として解釈される場合があり、例えば、その正規表現にフラグがある場合など。
12.10.3.2 自動セミコロン挿入と「[no LineTerminator here]」のケース
この節は規範的ではない。
ECMAScript には「[no
この節の残りでは、この ECMAScript バージョンで「[no
12.10.3.2.1 オペランドがオプションで「[no LineTerminator here]」を持つ文法生成規則一覧
UpdateExpression .ContinueStatement .BreakStatement .ReturnStatement .YieldExpression .- Async Function 定義（
15.8 ）と Function 定義（15.2 ）の関係のケース
13 ECMAScript言語：式（Expressions）
13.1 識別子（Identifiers）
構文
yield および await は文法上
let
await 0;13.1.1 静的セマンティクス：早期エラー（Early Errors）
-
IsStrict (この生成規則)がtrue の場合、Identifier のStringValue が"arguments" または"eval" であれば、構文エラーである。
-
IsStrict (この生成規則)がtrue の場合、構文エラーである。
- この生成規則が [Yield] パラメータを持つ場合、構文エラーである。
- この生成規則が [Await] パラメータを持つ場合、構文エラーである。
-
この生成規則が [Yield] パラメータを持ち、かつ
Identifier のStringValue が"yield" である場合、構文エラーである。 -
この生成規則が [Await] パラメータを持ち、かつ
Identifier のStringValue が"await" である場合、構文エラーである。
-
IsStrict (この句)がtrue であり、IdentifierName のStringValue が"implements" ,"interface" ,"let" ,"package" ,"private" ,"protected" ,"public" ,"static" ,"yield" のいずれかの場合、構文エラーである。 -
構文文法の
ゴール記号 がModule であり、IdentifierName のStringValue が"await" の場合、構文エラーである。 -
IdentifierName のStringValue が、ReservedWord のyieldまたはawait以外のStringValue と同じ場合、構文エラーである。
13.1.2 静的セマンティクス：StringValue
- idTextUnescaped を、
IdentifierName のIdentifierCodePoints とする。 CodePointsToString (idTextUnescaped) を返す。
"yield" を返す。
"await" を返す。
IdentifierName のStringValue を返す。
- 0x0023（番号記号）と、
IdentifierName のStringValue のstring-concatenation を返す。
StringLiteral のSV を返す。
13.1.3 実行時意味論：評価（Evaluation）
Identifier のStringValue を引数として、ResolveBinding (...) を返す。
ResolveBinding ("yield" ) を返す。
ResolveBinding ("await" ) を返す。
yield
を識別子として使用できる。yield のバインディングを
13.2 基本式（Primary Expression）
構文
補助構文
次の生成規則のインスタンスを処理する際、
13.2.1 this キーワード
13.2.1.1 実行時意味論：評価
- Return ?
ResolveThisBinding () を返す。
13.2.2 識別子参照
13.2.3 リテラル
構文
13.2.3.1 実行時意味論：評価
null を返す。
BooleanLiteral がトークンfalseの場合、false を返す。BooleanLiteral がトークンtrueの場合、true を返す。
NumericLiteral のNumericValue を、12.9.3 で定義されている通りに返す。
StringLiteral のSV を、12.9.4.2 で定義されている通りに返す。
13.2.4 配列初期化子
配列要素は、要素リストの先頭、中間、末尾で省略することができる。要素リスト内のコンマが
構文
13.2.4.1 実行時意味論：ArrayAccumulation
- ?
ArrayAccumulation のElision に array および (nextIndex + 1) を引数として呼び出し、その結果を返す。
Elision が存在する場合、- nextIndex を ?
ArrayAccumulation のElision に array および nextIndex を引数として呼び出した結果に設定する。
- nextIndex を ?
- initResult を ?
Evaluation のAssignmentExpression による評価結果とする。 - initValue を ?
GetValue (initResult) とする。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue) を実行する。 - nextIndex + 1 を返す。
Elision が存在する場合、- nextIndex を ?
ArrayAccumulation のElision に array および nextIndex を引数として呼び出した結果に設定する。
- nextIndex を ?
- ?
ArrayAccumulation のSpreadElement に array および nextIndex を引数として呼び出した結果を返す。
- nextIndex を ?
ArrayAccumulation のElementList に array および nextIndex を引数として呼び出した結果に設定する。 Elision が存在する場合、- nextIndex を ?
ArrayAccumulation のElision に array および nextIndex を引数として呼び出した結果に設定する。
- nextIndex を ?
- initResult を ?
Evaluation のAssignmentExpression による評価結果とする。 - initValue を ?
GetValue (initResult) とする。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue) を実行する。 - nextIndex + 1 を返す。
- nextIndex を ?
ArrayAccumulation のElementList に array および nextIndex を引数として呼び出した結果に設定する。 Elision が存在する場合、- nextIndex を ?
ArrayAccumulation のElision に array および nextIndex を引数として呼び出した結果に設定する。
- nextIndex を ?
- ?
ArrayAccumulation のSpreadElement に array および nextIndex を引数として呼び出した結果を返す。
- spreadRef を ?
Evaluation のAssignmentExpression による評価結果とする。 - spreadObj を ?
GetValue (spreadRef) とする。 - iteratorRecord を ?
GetIterator (spreadObj,sync ) とする。 - 繰り返し、
- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done であれば、nextIndex を返す。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), next) を実行する。 - nextIndex を nextIndex + 1 に設定する。
- next を ?
13.2.4.2 実行時意味論：評価
- array を !
ArrayCreate (0) とする。 Elision が存在する場合、- ?
ArrayAccumulation のElision に array および 0 を引数として呼び出す。
- ?
- array を返す。
- array を !
ArrayCreate (0) とする。 - ?
ArrayAccumulation のElementList に array および 0 を引数として呼び出す。 - array を返す。
- array を !
ArrayCreate (0) とする。 - nextIndex を ?
ArrayAccumulation のElementList に array および 0 を引数として呼び出した結果に設定する。 Elision が存在する場合、- ?
ArrayAccumulation のElision に array および nextIndex を引数として呼び出す。
- ?
- array を返す。
13.2.5 オブジェクト初期化子
オブジェクト初期化子は、リテラルに似た形式で記述されるオブジェクトの初期化を表す式である。ゼロ個以上の
構文
特定の文脈では、
13.2.5.1 静的セマンティクス：早期エラー
-
MethodDefinition のHasDirectSuper がtrue の場合、構文エラーである。 -
MethodDefinition のPrivateBoundIdentifiers が空でない場合、構文エラーである。
実際のオブジェクト初期化子を記述することに加えて、
- この生成規則に一致するソーステキストがある場合、構文エラーである。
この生成規則は、
-
PropertyDefinitionList のPropertyNameList に"__proto__" の重複エントリが存在し、そのうち少なくとも2つが次の形式の生成規則から得られた場合、構文エラーである：PropertyDefinition : PropertyName : AssignmentExpression ObjectLiteral がParseJSON 用に構文解析されているScript に含まれる場合には適用されない（3 ステップを参照）。
13.2.5.2 静的セマンティクス：IsComputedPropertyKey
false を返す。
true を返す。
13.2.5.3 静的セマンティクス：PropertyNameList
- propName を
PropertyDefinition のPropName とする。 - propName が
empty の場合、新しい空のList を返す。 - « propName » を返す。
- list を
PropertyDefinitionList のPropertyNameList とする。 - propName を
PropertyDefinition のPropName とする。 - propName が
empty の場合、list を返す。 - list と « propName » の
list-concatenation を返す。
13.2.5.4 実行時意味論：評価
- obj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - ?
PropertyDefinitionEvaluation のPropertyDefinitionList に引数 obj で実行する。 - obj を返す。
IdentifierName のStringValue を返す。
StringLiteral のSV を返す。
- nbr を
NumericLiteral のNumericValue とする。 - !
ToString (nbr) を返す。
- exprValue を ?
Evaluation のAssignmentExpression による評価結果とする。 - propName を ?
GetValue (exprValue) とする。 - ?
ToPropertyKey (propName) を返す。
13.2.5.5 実行時意味論：PropertyDefinitionEvaluation
- ?
PropertyDefinitionEvaluation のPropertyDefinitionList に引数 object で実行する。 - ?
PropertyDefinitionEvaluation のPropertyDefinition に引数 object で実行する。 unused を返す。
- exprValue を ?
Evaluation のAssignmentExpression による評価結果とする。 - fromValue を ?
GetValue (exprValue) とする。 - excludedNames を新しい空の
List とする。 - ?
CopyDataProperties (object, fromValue, excludedNames) を実行する。 unused を返す。
- propName を
IdentifierReference のStringValue とする。 - exprValue を ?
Evaluation のIdentifierReference による評価結果とする。 - propValue を ?
GetValue (exprValue) とする。 Assert : object は通常の拡張可能なオブジェクトであり、非設定可能プロパティを持たない。- !
CreateDataPropertyOrThrow (object, propName, propValue) を実行する。 unused を返す。
- propKey を ?
Evaluation のPropertyName による評価結果とする。 - この
PropertyDefinition がParseJSON 用に評価されているScript に含まれる場合、- isProtoSetter を
false とする。
- isProtoSetter を
- そうでなく、propKey が
"__proto__" かつPropertyName のIsComputedPropertyKey がfalse の場合、- isProtoSetter を
true とする。
- isProtoSetter を
- その他の場合、
- isProtoSetter を
false とする。
- isProtoSetter を
IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue かつ isProtoSetter がfalse の場合、- propValue を ?
NamedEvaluation のAssignmentExpression に引数 propKey で実行した結果とする。
- propValue を ?
- そうでない場合、
- exprValueRef を ?
Evaluation のAssignmentExpression による評価結果とする。 - propValue を ?
GetValue (exprValueRef) とする。
- exprValueRef を ?
- isProtoSetter が
true の場合、- propValue が
オブジェクト であるか、または propValue がnull の場合、- ! object.[[SetPrototypeOf]](propValue) を実行する。
unused を返す。
- propValue が
Assert : object は通常の拡張可能なオブジェクトであり、非設定可能プロパティを持たない。- !
CreateDataPropertyOrThrow (object, propKey, propValue) を実行する。 unused を返す。
- ?
MethodDefinitionEvaluation のMethodDefinition に引数 object およびtrue で実行する。 unused を返す。
13.2.6 関数定義式
13.2.7 正規表現リテラル
構文
13.2.7.1 静的セマンティクス：早期エラー
-
IsValidRegularExpressionLiteral (RegularExpressionLiteral ) がfalse の場合、構文エラーである。
13.2.7.2 静的セマンティクス：IsValidRegularExpressionLiteral ( literal )
抽象操作 IsValidRegularExpressionLiteral は、引数 literal（
- flags を literal の
FlagText とする。 - flags に
d、g、i、m、s、u、v、y以外のコードポイントが含まれている場合、または flags に同じコードポイントが複数回含まれている場合、false を返す。 - flags に
uが含まれている場合、u をtrue とし、そうでなければfalse とする。 - flags に
vが含まれている場合、v をtrue とし、そうでなければfalse とする。 - patternText を literal の
BodyText とする。 - u が
false かつ v がfalse の場合、- stringValue を
CodePointsToString (patternText) とする。 - patternText を stringValue の各16ビット要素を Unicode BMP コードポイントとして解釈したコードポイント列に設定する。UTF-16 デコードは行わない。
- stringValue を
- parseResult を
ParsePattern (patternText, u, v) とする。 - parseResult が
構文ノード である場合、true を返す。そうでなければfalse を返す。
13.2.7.3 実行時意味論：評価
- pattern を
CodePointsToString (BodyText ofRegularExpressionLiteral ) とする。 - flags を
CodePointsToString (FlagText ofRegularExpressionLiteral ) とする。 - !
RegExpCreate (pattern, flags) を返す。
13.2.8 テンプレートリテラル
構文
13.2.8.1 静的セマンティクス：早期エラー
-
[Tagged] パラメータが設定されていない場合、
NoSubstitutionTemplate がContains NotEscapeSequence であれば構文エラーである。
-
TemplateLiteral のTemplateStrings の要素数をfalse を引数として求めたとき、その値が 232 以上であれば構文エラーである。
-
[Tagged] パラメータが設定されていない場合、
TemplateHead がContains NotEscapeSequence であれば構文エラーである。
-
[Tagged] パラメータが設定されていない場合、
TemplateTail がContains NotEscapeSequence であれば構文エラーである。
-
[Tagged] パラメータが設定されていない場合、
TemplateMiddle がContains NotEscapeSequence であれば構文エラーである。
13.2.8.2 静的セマンティクス：TemplateStrings
- «
TemplateString (NoSubstitutionTemplate , raw) » を返す。
- head を «
TemplateString (TemplateHead , raw) » とする。 - tail を
TemplateSpans のTemplateStrings （引数 raw）とする。 - head と tail の
list-concatenation を返す。
- «
TemplateString (TemplateTail , raw) » を返す。
- middle を
TemplateMiddleList のTemplateStrings （引数 raw）とする。 - tail を «
TemplateString (TemplateTail , raw) » とする。 - middle と tail の
list-concatenation を返す。
- «
TemplateString (TemplateMiddle , raw) » を返す。
- front を
TemplateMiddleList のTemplateStrings （引数 raw）とする。 - last を «
TemplateString (TemplateMiddle , raw) » とする。 - front と last の
list-concatenation を返す。
13.2.8.3 静的セマンティクス：TemplateString ( templateToken, raw )
抽象操作 TemplateString は、引数 templateToken（
この操作は、raw が
13.2.8.4 GetTemplateObject ( templateLiteral )
抽象操作 GetTemplateObject は、引数 templateLiteral（
- realm を
現在の Realm Record とする。 - templateRegistry を realm.[[TemplateMap]] とする。
- templateRegistry の各要素 e について、
- e.[[Site]] が templateLiteral
と
同じ構文ノード であれば、- e.[[Array]] を返す。
- e.[[Site]] が templateLiteral
と
- rawStrings を templateLiteral の
TemplateStrings （引数true ）とする。 Assert : rawStrings は String のList である。- cookedStrings を templateLiteral の
TemplateStrings （引数false ）とする。 - count を cookedStrings の
List の要素数とする。 Assert : count ≤ 232 - 1.- template を !
ArrayCreate (count) とする。 - rawObj を !
ArrayCreate (count) とする。 - index を 0 とする。
- index < count の間、繰り返す：
- prop を !
ToString (𝔽 (index)) とする。 - cookedValue を cookedStrings[index] とする。
- !
DefinePropertyOrThrow (template, prop, PropertyDescriptor { [[Value]]: cookedValue, [[Writable]]:false , [[Enumerable]]:true , [[Configurable]]:false }) を実行する。 - rawValue を rawStrings[index] の String 値とする。
- !
DefinePropertyOrThrow (rawObj, prop, PropertyDescriptor { [[Value]]: rawValue, [[Writable]]:false , [[Enumerable]]:true , [[Configurable]]:false }) を実行する。 - index を index + 1 に設定する。
- prop を !
- !
SetIntegrityLevel (rawObj,frozen ) を実行する。 - !
DefinePropertyOrThrow (template,"raw" , PropertyDescriptor { [[Value]]: rawObj, [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - !
SetIntegrityLevel (template,frozen ) を実行する。 - realm.[[TemplateMap]] に
Record { [[Site]]: templateLiteral, [[Array]]: template } を追加する。 - template を返す。
テンプレートオブジェクトの生成で
この仕様の将来の版で、テンプレートオブジェクトの追加の列挙不可プロパティが定義される可能性がある。
13.2.8.5 実行時意味論：SubstitutionEvaluation
- 新しい空の
List を返す。
- ?
SubstitutionEvaluation のTemplateMiddleList を返す。
- subRef を ?
Evaluation のExpression による評価結果とする。 - sub を ?
GetValue (subRef) とする。 - « sub » を返す。
- preceding を ?
SubstitutionEvaluation のTemplateMiddleList を返す。 - nextRef を ?
Evaluation のExpression による評価結果とする。 - next を ?
GetValue (nextRef) とする。 - preceding と « next » の
list-concatenation を返す。
13.2.8.6 実行時意味論：評価
NoSubstitutionTemplate のTV を12.9.6 で定義された通りに返す。
- head を
TemplateHead のTV とし、12.9.6 で定義された通りとする。 - subRef を ?
Evaluation のExpression による評価結果とする。 - sub を ?
GetValue (subRef) とする。 - middle を ?
ToString (sub) とする。 - tail を ?
Evaluation のTemplateSpans とする。 - head、middle、tail の
string-concatenation を返す。
String.prototype.concat のようなものであり、+
演算子とは異なる。
TemplateTail のTV を12.9.6 で定義された通りに返す。
- head を ?
Evaluation のTemplateMiddleList とする。 - tail を
TemplateTail のTV とし、12.9.6 で定義された通りとする。 - head と tail の
string-concatenation を返す。
- head を
TemplateMiddle のTV とし、12.9.6 で定義された通りとする。 - subRef を ?
Evaluation のExpression による評価結果とする。 - sub を ?
GetValue (subRef) とする。 - middle を ?
ToString (sub) とする。 - head と middle の
string-concatenation を返す。
String.prototype.concat のようなものであり、+
演算子とは異なる。
- rest を、
TemplateMiddleList の ?Evaluation とする。 - middle を、
TemplateMiddle のTV （12.9.6 で定義）とする。 - subRef を、
Expression の ?Evaluation とする。 - sub を、
GetValue (subRef) の ? 結果とする。 - last を、
ToString (sub) の ? 結果とする。 - rest、middle、last の
string-concatenation を返す。
+ 演算子ではなく String.prototype.concat
に類似している。
13.2.9 グルーピング演算子
13.2.9.1 静的セマンティクス：早期エラー
-
CoverParenthesizedExpressionAndArrowParameterList は、必ず ParenthesizedExpression をカバーしなければならない。
13.2.9.2 実行時意味論：評価
- expr を、
CoverParenthesizedExpressionAndArrowParameterList によってカバーされている ParenthesizedExpression とする。 - ?
Evaluation of expr を返す。
Expression の ?Evaluation を返す。これが Reference 型の場合もある。
このアルゴリズムは、delete や typeof などの演算子が括弧付き式に適用できるようにするためである。
13.3 左辺式（Left-Hand-Side Expressions）
構文
補助構文
次の生成規則のインスタンスを処理する際、
13.3.1 静的セマンティクス
13.3.1.1 静的セマンティクス：早期エラー
- この生成規則に一致するソーステキストがある場合、構文エラーとなる。
この生成規則は、次のコードに対して自動セミコロン挿入規則（
a?.b
`c`このように2つの有効な文として解釈されるようにするためである。目的は、オプショナルチェーンなしの同様のコードとの一貫性を保つことである：
a.b
`c`これは有効な文であり、自動セミコロン挿入は適用されない。
13.3.2 プロパティアクセス
プロパティは名前でアクセスされ、ドット記法またはブラケット記法のいずれかを使う：
またはブラケット記法：
ドット記法は次の構文変換で説明できる：
これは次と同じ挙動となる：
同様に、
これは次と同じ挙動となる：
ここで <identifier-name-string> は
13.3.2.1 実行時意味論：評価
- baseReference を、
MemberExpression の ?Evaluation とする。 - baseValue を ?
GetValue (baseReference) とする。 - strict を
IsStrict (このMemberExpression ) とする。 - ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict) を返す。
- baseReference を、
MemberExpression の ?Evaluation とする。 - baseValue を ?
GetValue (baseReference) とする。 - strict を
IsStrict (このMemberExpression ) とする。 EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict) を返す。
- baseReference を、
MemberExpression の ?Evaluation とする。 - baseValue を ?
GetValue (baseReference) とする。 - fieldNameString を
PrivateIdentifier のStringValue とする。 MakePrivateReference (baseValue, fieldNameString) を返す。
- baseReference を、
CallExpression の ?Evaluation とする。 - baseValue を ?
GetValue (baseReference) とする。 - strict を
IsStrict (このCallExpression ) とする。 - ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict) を返す。
- baseReference を、
CallExpression の ?Evaluation とする。 - baseValue を ?
GetValue (baseReference) とする。 - strict を
IsStrict (このCallExpression ) とする。 EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict) を返す。
- baseReference を、
CallExpression の ?Evaluation とする。 - baseValue を ?
GetValue (baseReference) とする。 - fieldNameString を
PrivateIdentifier のStringValue とする。 MakePrivateReference (baseValue, fieldNameString) を返す。
13.3.3 EvaluatePropertyAccessWithExpressionKey ( baseValue, expression, strict )
抽象操作 EvaluatePropertyAccessWithExpressionKey は、引数 baseValue（
- propertyNameReference を expression の ?
Evaluation とする。 - propertyNameValue を ?
GetValue (propertyNameReference) とする。 - 注：ほとんどの場合、propertyNameValue に
ToPropertyKey が直後に適用される。ただしa[b] = cの場合はcの評価後まで行われない。 Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyNameValue, [[Strict]]: strict, [[ThisValue]]:empty } を返す。
13.3.4 EvaluatePropertyAccessWithIdentifierKey ( baseValue, identifierName, strict )
抽象操作 EvaluatePropertyAccessWithIdentifierKey は、引数 baseValue（
- propertyNameString を identifierName の
StringValue とする。 Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyNameString, [[Strict]]: strict, [[ThisValue]]:empty } を返す。
13.3.5 new 演算子
13.3.5.1 実行時意味論：評価
- ?
EvaluateNew (NewExpression ,empty ) を返す。
- ?
EvaluateNew (MemberExpression ,Arguments ) を返す。
13.3.5.1.1 EvaluateNew ( constructExpr, arguments )
抽象操作 EvaluateNew は、引数 constructExpr（
- ref を constructExpr の ?
Evaluation とする。 - constructor を ?
GetValue (ref) とする。 - arguments が
empty の場合、- argList を新しい空の
List とする。
- argList を新しい空の
- それ以外の場合、
- argList を arguments の ?
ArgumentListEvaluation とする。
- argList を arguments の ?
IsConstructor (constructor) がfalse の場合、TypeError 例外をスローする。- ?
Construct (constructor, argList) を返す。
13.3.6 関数呼び出し
13.3.6.1 実行時意味論：評価
- expr を、
CoverCallExpressionAndAsyncArrowHead によってカバーされている CallMemberExpression とする。 - memberExpr を expr の
MemberExpression とする。 - arguments を expr の
Arguments とする。 - ref を memberExpr の ?
Evaluation とする。 - func を ?
GetValue (ref) とする。 - ref が
Reference Record であり、IsPropertyReference (ref) がfalse で、かつ ref.[[ReferencedName]] が"eval" の場合、SameValue (func,%eval% ) がtrue の場合、- argList を arguments の ?
ArgumentListEvaluation とする。 - argList に要素がなければ
undefined を返す。 - evalArg を argList の最初の要素とする。
- この
CallExpression のIsStrict がtrue なら strictCaller をtrue 、それ以外はfalse とする。 - ?
PerformEval (evalArg, strictCaller,true ) を返す。
- argList を arguments の ?
- thisCall をこの
CallExpression とする。 - tailCall を
IsInTailPosition (thisCall) とする。 - ?
EvaluateCall (func, ref, arguments, tailCall) を返す。
- ref を
CallExpression の ?Evaluation とする。 - func を ?
GetValue (ref) とする。 - thisCall をこの
CallExpression とする。 - tailCall を
IsInTailPosition (thisCall) とする。 - ?
EvaluateCall (func, ref,Arguments , tailCall) を返す。
13.3.6.2 EvaluateCall ( func, ref, arguments, tailPosition )
抽象操作 EvaluateCall は、引数 func（
- ref が
Reference Record の場合、IsPropertyReference (ref) がtrue の場合、- thisValue を
GetThisValue (ref) とする。
- thisValue を
- それ以外の場合、
- それ以外の場合、
- thisValue を
undefined とする。
- thisValue を
- argList を arguments の ?
ArgumentListEvaluation とする。 - func が
オブジェクトでない 場合、TypeError 例外をスローする。 IsCallable (func) がfalse の場合、TypeError 例外をスローする。- tailPosition が
true の場合、PrepareForTailCall () を実行する。 - ?
Call (func, thisValue, argList) を返す。
13.3.7 super キーワード
13.3.7.1 実行時意味論：評価
- env を
GetThisEnvironment () とする。 - actualThis を ? env.GetThisBinding() とする。
- propertyNameReference を
Expression の ?Evaluation とする。 - propertyNameValue を ?
GetValue (propertyNameReference) とする。 - strict を
IsStrict (このSuperProperty ) とする。 - 注：ほとんどの場合、propertyNameValue に
ToPropertyKey が直後に適用される。ただしsuper[b] = cの場合はcの評価後まで行われない。 MakeSuperPropertyReference (actualThis, propertyNameValue, strict) を返す。
- env を
GetThisEnvironment () とする。 - actualThis を ? env.GetThisBinding() とする。
- propertyKey を
IdentifierName のStringValue とする。 - strict を
IsStrict (このSuperProperty ) とする。 MakeSuperPropertyReference (actualThis, propertyKey, strict) を返す。
- newTarget を
GetNewTarget () とする。 アサート : newTarget はコンストラクタ である。- func を
GetSuperConstructor () とする。 - argList を
Arguments の ?ArgumentListEvaluation とする。 IsConstructor (func) がfalse の場合、TypeError 例外をスローする。- result を ?
Construct (func, argList, newTarget) とする。 - thisER を
GetThisEnvironment () とする。 アサート : thisER は関数環境レコード である。- ?
BindThisValue (thisER, result) を実行する。 - F を thisER.[[FunctionObject]] とする。
アサート : F は ECMAScript の関数オブジェクト である。- ?
InitializeInstanceElements (result, F) を実行する。 - result を返す。
13.3.7.2 GetSuperConstructor ( )
抽象操作 GetSuperConstructor は引数を取らず、
- envRec を
GetThisEnvironment () とする。 アサート : envRec は関数環境レコード である。- activeFunction を envRec.[[FunctionObject]] とする。
アサート : activeFunction は ECMAScript の関数オブジェクト である。- superConstructor を ! activeFunction.[[GetPrototypeOf]]() とする。
- superConstructor を返す。
13.3.7.3 MakeSuperPropertyReference ( actualThis, propertyKey, strict )
抽象操作 MakeSuperPropertyReference は、引数 actualThis（
- env を
GetThisEnvironment () とする。 アサート : env.HasSuperBinding() はtrue である。アサート : env は関数環境レコード である。- baseValue を
GetSuperBase (env) とする。 Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyKey, [[Strict]]: strict, [[ThisValue]]: actualThis } を返す。
13.3.8 引数リスト
引数リストの評価は、値の
13.3.8.1 実行時意味論：ArgumentListEvaluation
- 新しい空の
リスト を返す。
- ref を
AssignmentExpression の ?Evaluation とする。 - arg を ?
GetValue (ref) とする。 - « arg » を返す。
- list を新しい空の
リスト とする。 - spreadRef を
AssignmentExpression の ?Evaluation とする。 - spreadObj を ?
GetValue (spreadRef) とする。 - iteratorRecord を ?
GetIterator (spreadObj,sync ) とする。 - 繰り返す：
- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done なら list を返す。 - next を list に追加する。
- next を ?
- precedingArgs を
ArgumentList の ?ArgumentListEvaluation とする。 - ref を
AssignmentExpression の ?Evaluation とする。 - arg を ?
GetValue (ref) とする。 - precedingArgs と « arg » の
list-concatenation を返す。
- precedingArgs を
ArgumentList の ?ArgumentListEvaluation とする。 - spreadRef を
AssignmentExpression の ?Evaluation とする。 - iteratorRecord を ?
GetIterator (?GetValue (spreadRef),sync ) とする。 - 繰り返す：
- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done なら precedingArgs を返す。 - next を precedingArgs に追加する。
- next を ?
- templateLiteral をこの
TemplateLiteral とする。 - siteObj を
GetTemplateObject (templateLiteral) とする。 - « siteObj » を返す。
- templateLiteral をこの
TemplateLiteral とする。 - siteObj を
GetTemplateObject (templateLiteral) とする。 - remaining を
SubstitutionTemplate の ?ArgumentListEvaluation とする。 - « siteObj » と remaining の
list-concatenation を返す。
- firstSubRef を
Expression の ?Evaluation とする。 - firstSub を ?
GetValue (firstSubRef) とする。 - restSub を
TemplateSpans の ?SubstitutionEvaluation とする。 アサート : restSub は空でもよいリスト である。- « firstSub » と restSub の
list-concatenation を返す。
13.3.9 オプショナルチェーン
?.
トークンで始まる。13.3.9.1 実行時意味論：評価
- baseReference を
MemberExpression の ?Evaluation とする。 - baseValue を ?
GetValue (baseReference) とする。 - baseValue が
undefined またはnull のいずれかの場合、undefined を返す。
OptionalChain の ?ChainEvaluation （引数 baseValue および baseReference）を返す。
- baseReference を
CallExpression の ?Evaluation とする。 - baseValue を ?
GetValue (baseReference) とする。 - baseValue が
undefined またはnull のいずれかの場合、undefined を返す。
OptionalChain の ?ChainEvaluation （引数 baseValue および baseReference）を返す。
- baseReference を
OptionalExpression の ?Evaluation とする。 - baseValue を ?
GetValue (baseReference) とする。 - baseValue が
undefined またはnull のいずれかの場合、undefined を返す。
OptionalChain の ?ChainEvaluation （引数 baseValue および baseReference）を返す。
13.3.9.2 実行時意味論：ChainEvaluation
- thisChain をこの
OptionalChain とする。 - tailCall を
IsInTailPosition (thisChain) とする。 - ?
EvaluateCall (baseValue, baseReference,Arguments , tailCall) を返す。
- strict を
IsStrict (このOptionalChain ) とする。 - ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict) を返す。
- strict を
IsStrict (このOptionalChain ) とする。 EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict) を返す。
- fieldNameString を
PrivateIdentifier のStringValue とする。 MakePrivateReference (baseValue, fieldNameString) を返す。
- optionalChain を
OptionalChain とする。 - newReference を optionalChain の ?
ChainEvaluation （引数 baseValue および baseReference）とする。 - newValue を ?
GetValue (newReference) とする。 - thisChain をこの
OptionalChain とする。 - tailCall を
IsInTailPosition (thisChain) とする。 - ?
EvaluateCall (newValue, newReference,Arguments , tailCall) を返す。
- optionalChain を
OptionalChain とする。 - newReference を optionalChain の ?
ChainEvaluation （引数 baseValue および baseReference）とする。 - newValue を ?
GetValue (newReference) とする。 - strict を
IsStrict (このOptionalChain ) とする。 - ?
EvaluatePropertyAccessWithExpressionKey (newValue,Expression , strict) を返す。
- optionalChain を
OptionalChain とする。 - newReference を optionalChain の ?
ChainEvaluation （引数 baseValue および baseReference）とする。 - newValue を ?
GetValue (newReference) とする。 - strict を
IsStrict (このOptionalChain ) とする。 EvaluatePropertyAccessWithIdentifierKey (newValue,IdentifierName , strict) を返す。
- optionalChain を
OptionalChain とする。 - newReference を optionalChain の ?
ChainEvaluation （引数 baseValue および baseReference）とする。 - newValue を ?
GetValue (newReference) とする。 - fieldNameString を
PrivateIdentifier のStringValue とする。 MakePrivateReference (newValue, fieldNameString) を返す。
13.3.10 import呼び出し
13.3.10.1 実行時意味論：評価
- ?
EvaluateImportCall (最初のAssignmentExpression , 2番目のAssignmentExpression )を返す。
13.3.10.2 EvaluateImportCall ( specifierExpression [ , optionsExpression ] )
抽象操作EvaluateImportCallは、引数specifierExpression（
- referrer を
GetActiveScriptOrModule () とする。 - referrer が
null なら、referrer に現在のRealm Record を設定する。 - specifierRef を specifierExpression の ?
Evaluation とする。 - specifier を ?
GetValue (specifierRef) とする。 - optionsExpression が存在する場合、
- optionsRef を optionsExpression の ?
Evaluation とする。 - options を ?
GetValue (optionsRef) とする。
- optionsRef を optionsExpression の ?
- それ以外の場合、
- options を
undefined とする。
- options を
- promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - specifierString を
Completion (ToString (specifier)) とする。 IfAbruptRejectPromise (specifierString, promiseCapability) を実行する。- attributes を新しい空の
リスト とする。 - options が
undefined でない場合、- options
がオブジェクトでない 場合、- !
Call (promiseCapability.[[Reject]],undefined , « 新しく作成されたTypeError オブジェクト ») を実行。 - promiseCapability.[[Promise]] を返す。
- !
- attributesObj を
Completion (Get (options,"with" )) とする。 IfAbruptRejectPromise (attributesObj, promiseCapability) を実行する。- attributesObj が
undefined でない場合、- attributesObj
がオブジェクトでない 場合、- !
Call (promiseCapability.[[Reject]],undefined , « 新しく作成されたTypeError オブジェクト ») を実行。 - promiseCapability.[[Promise]] を返す。
- !
- entries を
Completion (EnumerableOwnProperties (attributesObj,key+value )) とする。 IfAbruptRejectPromise (entries, promiseCapability) を実行する。- entries の各要素 entry について、
- key を !
Get (entry,"0" ) とする。 - value を !
Get (entry,"1" ) とする。 - key が
String型 の場合、- value が
String型でない 場合、- !
Call (promiseCapability.[[Reject]],undefined , « 新しく作成されたTypeError オブジェクト ») を実行。 - promiseCapability.[[Promise]] を返す。
- !
ImportAttribute Record { [[Key]]: key, [[Value]]: value } を attributes に追加する。
- value が
- key を !
- attributesObj
AllImportAttributesSupported (attributes) がfalse の場合、- !
Call (promiseCapability.[[Reject]],undefined , « 新しく作成されたTypeError オブジェクト ») を実行。 - promiseCapability.[[Promise]] を返す。
- !
- attributes を、その各要素の[[Key]]フィールドをUTF-16コード単位列として扱い、辞書式順序でソートする。注：このソートは、
ホスト が属性の列挙順に基づいて動作を変えるのを禁止することだけが観測可能である。
- options
- moduleRequest を新しい
ModuleRequest Record { [[Specifier]]: specifierString, [[Attributes]]: attributes } とする。 HostLoadImportedModule (referrer, moduleRequest,empty , promiseCapability) を実行する。- promiseCapability.[[Promise]] を返す。
13.3.10.3 ContinueDynamicImport ( promiseCapability, moduleCompletion )
抽象操作ContinueDynamicImportは、引数promiseCapability（import()
- moduleCompletion が
急激な完了 の場合、- !
Call (promiseCapability.[[Reject]],undefined , « moduleCompletion.[[Value]] ») を実行する。 unused を返す。
- !
- module を moduleCompletion.[[Value]] とする。
- loadPromise を module.LoadRequestedModules() とする。
- rejectedClosure
を、パラメータ(reason)を持ちpromiseCapabilityをキャプチャし、呼び出し時に以下を行う新しい
抽象クロージャ とする：- !
Call (promiseCapability.[[Reject]],undefined , « reason ») を実行する。 NormalCompletion (undefined ) を返す。
- !
- onRejected を
CreateBuiltinFunction (rejectedClosure, 1,"" , « ») とする。 - linkAndEvaluateClosure
を、パラメータなしでmodule、promiseCapability、onRejectedをキャプチャし、呼び出し時に以下を行う新しい
抽象クロージャ とする：- link を
Completion (module.Link()) とする。 - link が
急激な完了 の場合、- !
Call (promiseCapability.[[Reject]],undefined , « link.[[Value]] ») を実行する。 NormalCompletion (undefined ) を返す。
- !
- evaluatePromise を module.Evaluate() とする。
- fulfilledClosure
を、パラメータなしでmoduleとpromiseCapabilityをキャプチャし、呼び出し時に以下を行う新しい
抽象クロージャ とする：- namespace を
GetModuleNamespace (module) とする。 - ! Call(promiseCapability.[[Resolve]],
undefined , « namespace ») を実行する。 NormalCompletion (undefined ) を返す。
- namespace を
- onFulfilled を
CreateBuiltinFunction (fulfilledClosure, 0,"" , « ») とする。 PerformPromiseThen (evaluatePromise, onFulfilled, onRejected) を実行する。unused を返す。
- link を
- linkAndEvaluate を
CreateBuiltinFunction (linkAndEvaluateClosure, 0,"" , « ») とする。 PerformPromiseThen (loadPromise, linkAndEvaluate, onRejected) を実行する。unused を返す。
13.3.11 タグ付きテンプレート
タグ付きテンプレートは、呼び出しの引数が
13.3.11.1 実行時意味論：評価
- tagRef を
MemberExpression の ?Evaluation とする。 - tagFunc を ?
GetValue (tagRef) とする。 - thisCall をこの
MemberExpression とする。 - tailCall を
IsInTailPosition (thisCall) とする。 - ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall) を返す。
- tagRef を
CallExpression の ?Evaluation とする。 - tagFunc を ?
GetValue (tagRef) とする。 - thisCall をこの
CallExpression とする。 - tailCall を
IsInTailPosition (thisCall) とする。 - ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall) を返す。
13.3.12 メタプロパティ
13.3.12.1 実行時意味論：評価
GetNewTarget () を返す。
- module を
GetActiveScriptOrModule () とする。 アサート : module はSource Text Module Record である。- importMeta を module.[[ImportMeta]] とする。
- importMeta が
empty の場合、- importMeta に
OrdinaryObjectCreate (null ) を設定する。 - importMetaValues を
HostGetImportMetaProperties (module) とする。 - importMetaValues の各
Record { [[Key]], [[Value]] } p について、- !
CreateDataPropertyOrThrow (importMeta, p.[[Key]], p.[[Value]]) を実行する。
- !
HostFinalizeImportMeta (importMeta, module) を実行する。- module.[[ImportMeta]] に importMeta を設定する。
- importMeta を返す。
- importMeta に
- それ以外の場合、
アサート : importMetaはオブジェクトである 。- importMeta を返す。
13.3.12.1.1 HostGetImportMetaProperties ( moduleRecord )
import.metaから返されるオブジェクトに対して
HostGetImportMetaPropertiesのデフォルト実装は、新しい空の
13.3.12.1.2 HostFinalizeImportMeta ( importMeta, moduleRecord )
import.metaから返されるオブジェクトをECMAScriptコードに公開する前に特別な操作を行うことができる。
ほとんどの
HostFinalizeImportMetaのデフォルト実装は
13.4 更新式
構文
13.4.1 静的セマンティクス：早期エラー
-
LeftHandSideExpression のAssignmentTargetType がinvalid である場合、早期構文エラーとなる。
-
UnaryExpression のAssignmentTargetType がinvalid である場合、早期構文エラーとなる。
13.4.2 後置インクリメント演算子
13.4.2.1 実行時意味論：評価
- lhs を
LeftHandSideExpression の ?Evaluation とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat の場合、ReferenceError 例外をスローする。- oldValue を ?
ToNumeric (?GetValue (lhs)) とする。 - oldValue が
Number の場合、- newValue を
Number::add (oldValue,1 𝔽) とする。
- newValue を
- それ以外の場合、
アサート : oldValue はBigInt である。- newValue を
BigInt::add (oldValue,1 ℤ) とする。
- ?
PutValue (lhs, newValue) を実行する。 - oldValue を返す。
13.4.3 後置デクリメント演算子
13.4.3.1 実行時意味論：評価
- lhs を
LeftHandSideExpression の ?Evaluation とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat の場合、ReferenceError 例外をスローする。- oldValue を ?
ToNumeric (?GetValue (lhs)) とする。 - oldValue が
Number の場合、- newValue を
Number::subtract (oldValue,1 𝔽) とする。
- newValue を
- それ以外の場合、
アサート : oldValue はBigInt である。- newValue を
BigInt::subtract (oldValue,1 ℤ) とする。
- ?
PutValue (lhs, newValue) を実行する。 - oldValue を返す。
13.4.4 前置インクリメント演算子
13.4.4.1 実行時意味論：評価
- expr を
UnaryExpression の ?Evaluation とする。 UnaryExpression のAssignmentTargetType がweb-compat の場合、ReferenceError 例外をスローする。- oldValue を ?
ToNumeric (?GetValue (expr)) とする。 - oldValue が
Number の場合、- newValue を
Number::add (oldValue,1 𝔽) とする。
- newValue を
- それ以外の場合、
アサート : oldValue はBigInt である。- newValue を
BigInt::add (oldValue,1 ℤ) とする。
- ?
PutValue (expr, newValue) を実行する。 - newValue を返す。
13.4.5 前置デクリメント演算子
13.4.5.1 実行時意味論：評価
- expr を
UnaryExpression の ?Evaluation とする。 UnaryExpression のAssignmentTargetType がweb-compat の場合、ReferenceError 例外をスローする。- oldValue を ?
ToNumeric (?GetValue (expr)) とする。 - oldValue が
Number の場合、- newValue を
Number::subtract (oldValue,1 𝔽) とする。
- newValue を
- それ以外の場合、
アサート : oldValue はBigInt である。- newValue を
BigInt::subtract (oldValue,1 ℤ) とする。
- ?
PutValue (expr, newValue) を実行する。 - newValue を返す。
13.5 単項演算子
構文
13.5.1 delete 演算子
13.5.1.1 静的セマンティクス：早期エラー
-
IsStrict (UnaryExpression ) がtrue であり、導出されたUnaryExpression がPrimaryExpression : IdentifierReference MemberExpression : MemberExpression . PrivateIdentifier CallExpression : CallExpression . PrivateIdentifier OptionalChain : ?. PrivateIdentifier OptionalChain : OptionalChain . PrivateIdentifier -
導出された
UnaryExpression が
PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList
であり、かつCoverParenthesizedExpressionAndArrowParameterList が最終的にこれらの規則に従う場合に構文エラーを生成する句に導出される場合も構文エラーとなる。この規則は再帰的に適用される。
最後の規則は、delete (((foo))) のような式が、最初の規則を再帰的に適用することで
13.5.1.2 実行時意味論：評価
- ref を
UnaryExpression の ?Evaluation とする。 - ref が
Reference Record でない場合、true を返す。 IsUnresolvableReference (ref) がtrue の場合、アサート : ref.[[Strict]] はfalse である。true を返す。
IsPropertyReference (ref) がtrue の場合、アサート :IsPrivateReference (ref) はfalse である。IsSuperReference (ref) がtrue の場合、ReferenceError 例外をスローする。- baseObj を
ref.[[Base]] の ?
ToObject とする。 - ref.[[ReferencedName]] が
property key でない場合、- ref.[[ReferencedName]] に
?
ToPropertyKey (ref.[[ReferencedName]]) を設定する。
- ref.[[ReferencedName]] に
?
- deleteStatus を ? baseObj.[[Delete]](ref.[[ReferencedName]]) とする。
- deleteStatus が
false かつ ref.[[Strict]] がtrue の場合、TypeError 例外をスローする。 - deleteStatus を返す。
- それ以外の場合、
- base を ref.[[Base]] とする。
アサート : base はEnvironment Record である。- base.DeleteBinding(ref.[[ReferencedName]]) を返す。
delete 演算子が delete 演算子が削除対象のプロパティが { [[Configurable]]:
13.5.2 void 演算子
13.5.2.1 実行時意味論：評価
- expr を
UnaryExpression の ?Evaluation とする。 - ?
GetValue (expr) を実行する。 undefined を返す。
13.5.3 typeof 演算子
13.5.3.1 実行時意味論：評価
- val を
UnaryExpression の ?Evaluation とする。 - val が
Reference Record の場合、IsUnresolvableReference (val) がtrue なら"undefined" を返す。
- val を ?
GetValue (val) に設定する。 - val が
undefined なら"undefined" を返す。 - val が
null なら"object" を返す。 - val が
String の場合、"string" を返す。 - val が
Symbol の場合、"symbol" を返す。 - val が
Boolean の場合、"boolean" を返す。 - val が
Number の場合、"number" を返す。 - val が
BigInt の場合、"bigint" を返す。 アサート : val はオブジェクトである 。- 注：このステップは
B.3.6.3 で置き換えられる。 - val が [[Call]]
内部メソッドを持つ場合、
"function" を返す。 "object" を返す。
13.5.4 単項 + 演算子
単項+演算子は、そのオペランドを
13.5.4.1 実行時意味論：評価
- expr を
UnaryExpression の ?Evaluation とする。 - ?
ToNumber (?GetValue (expr)) を返す。
13.5.5 単項 - 演算子
単項 - 演算子は、そのオペランドを数値に変換し、次にそれを符号反転する。
13.5.5.1 実行時意味論：評価
- expr を
UnaryExpression の ?Evaluation とする。 - oldValue を ?
ToNumeric (?GetValue (expr)) とする。 - oldValue が
Number の場合、Number::unaryMinus (oldValue) を返す。
- それ以外の場合、
アサート : oldValue はBigInt である。BigInt::unaryMinus (oldValue) を返す。
13.5.6 ビット単位否定演算子 ( ~ )
13.5.6.1 実行時意味論：評価
- expr を
UnaryExpression の ?Evaluation とする。 - oldValue を ?
ToNumeric (?GetValue (expr)) とする。 - oldValue が
Number の場合、Number::bitwiseNOT (oldValue) を返す。
- それ以外の場合、
アサート : oldValue はBigInt である。BigInt::bitwiseNOT (oldValue) を返す。
13.5.7 論理否定演算子 ( ! )
13.5.7.1 実行時意味論：評価
- expr を
UnaryExpression の ?Evaluation とする。 - oldValue を
ToBoolean (?GetValue (expr)) とする。 - oldValue が
true ならfalse を返す。 true を返す。
13.6 累乗演算子
構文
13.6.1 実行時意味論：評価
13.7 乗除演算子
構文
*演算子は乗算を行い、被演算子の積を生成する。/演算子は除算を行い、被演算子の商を生成する。%演算子は、暗黙の除算から被演算子の剰余を返す。
13.7.1 実行時意味論：評価
- opText を
source text matched by MultiplicativeOperator とする。 - ?
EvaluateStringOrNumericBinaryExpression (MultiplicativeExpression , opText,ExponentiationExpression ) を返す。
13.8 加算演算子
構文
13.8.1 加算演算子 ( + )
加算演算子は、文字列連結または数値加算のいずれかを実行する。
13.8.1.1 実行時意味論：評価
13.8.2 減算演算子 ( - )
- 演算子は減算を行い、被演算子の差を生成する。
13.8.2.1 実行時意味論：評価
13.9 ビットシフト演算子
構文
13.9.1 左シフト演算子 ( << )
左オペランドのビットを、右オペランドで指定された分だけ左にシフトするビット単位の左シフト演算を行う。
13.9.1.1 実行時意味論：評価
13.9.2 符号付き右シフト演算子 ( >> )
左オペランドのビットを、右オペランドで指定された分だけ符号ビットを保持したまま右にシフトするビット単位の右シフト演算を行う。
13.9.2.1 実行時意味論：評価
13.9.3 符号なし右シフト演算子 ( >>>
)
左オペランドのビットを、右オペランドで指定された分だけゼロ埋めで右にシフトするビット単位の右シフト演算を行う。
13.9.3.1 実行時意味論：評価
13.10 関係演算子
関係演算子の評価結果は常にBoolean型であり、演算子が示す関係が2つのオペランド間で成り立つかどうかを反映する。
構文
[In] 文法パラメータは、関係式の in 演算子と for 文中の in
演算子との混同を避けるために必要である。
13.10.1 実行時意味論：評価
- lRef を
RelationalExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を
ShiftExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - r を ?
IsLessThan (lVal, rVal,true ) とする。 - r が
undefined ならfalse を返し、それ以外は r を返す。
- lRef を
RelationalExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を
ShiftExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - r を ?
IsLessThan (rVal, lVal,false ) とする。 - r が
undefined ならfalse を返し、それ以外は r を返す。
- lRef を
RelationalExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を
ShiftExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - r を ?
IsLessThan (rVal, lVal,false ) とする。 - r が
true またはundefined ならfalse を返し、それ以外はtrue を返す。
- lRef を
RelationalExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を
ShiftExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - r を ?
IsLessThan (lVal, rVal,true ) とする。 - r が
true またはundefined ならfalse を返し、それ以外はtrue を返す。
- lRef を
RelationalExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を
ShiftExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - ?
InstanceofOperator (lVal, rVal) を返す。
- lRef を
RelationalExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を
ShiftExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - rVal が
オブジェクトでない 場合、TypeError 例外をスローする。 - ?
HasProperty (rVal, ?ToPropertyKey (lVal)) を返す。
- privateIdentifier を
PrivateIdentifier のStringValue とする。 - rRef を
ShiftExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - rVal が
オブジェクトでない 場合、TypeError 例外をスローする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 アサート : privateEnv はnull でない。- privateName を
ResolvePrivateIdentifier (privateEnv, privateIdentifier) とする。 PrivateElementFind (rVal, privateName) がempty でない場合、true を返す。false を返す。
13.10.2 InstanceofOperator ( V, target )
抽象操作 InstanceofOperator は、引数 V（
- target が
オブジェクトでない 場合、TypeError 例外をスローする。 - instOfHandler を ?
GetMethod (target,%Symbol.hasInstance% ) とする。 - instOfHandler が
undefined でない場合、 IsCallable (target) がfalse の場合、TypeError 例外をスローする。- ?
OrdinaryHasInstance (target, V) を返す。
instanceof 演算子の意味論を定義していなかった以前のECMAScript版との互換性のために提供されている。オブジェクトが
instanceof 意味論が使われる。
13.11 等価演算子
等価演算子の評価結果は常にBoolean型であり、演算子が示す関係が2つのオペランド間で成り立つかどうかを反映する。
構文
13.11.1 実行時意味論：評価
- lRef を
EqualityExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を
RelationalExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - ?
IsLooselyEqual (rVal, lVal) を返す。
- lRef を
EqualityExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を
RelationalExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - r を ?
IsLooselyEqual (rVal, lVal) とする。 - r が
true ならfalse を返し、それ以外はtrue を返す。
- lRef を
EqualityExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を
RelationalExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 IsStrictlyEqual (rVal, lVal) を返す。
- lRef を
EqualityExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を
RelationalExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - r を
IsStrictlyEqual (rVal, lVal) とする。 - r が
true ならfalse を返し、それ以外はtrue を返す。
上記の等価の定義に基づく：
-
文字列比較を強制するには:
`${a}` == `${b}` -
数値比較を強制するには:
+a == +b -
真偽値比較を強制するには:
!a == !b
等価演算子は以下の不変性を維持する：
-
A != Bは!(A == B)と同値である。 -
A == BはB == Aと同値であるが、AとBの評価順は異なる。
等価演算子は常に推移的であるとは限りません。例えば、同じ文字列値を表す2つの異なるStringオブジェクトが存在する場合、それぞれのStringオブジェクトは==演算子によってその文字列値と等しいと見なされますが、2つのStringオブジェクト同士は等しくありません。例：
-
new String("a") == "a"および"a" == new String("a")はどちらもtrue です。 -
new String("a") == new String("a")はfalse です。
文字列の比較は、コード単位値の並びに対する単純な等価テストを使用します。Unicode仕様で定義されているより複雑で意味論的な文字や文字列の等価性や照合順序の定義は使用されません。そのため、Unicode Standardに従って正規等価なString値でも等しくないと判定される場合があります。実質的にこのアルゴリズムは、両方のStringがすでに正規化された形式であると仮定しています。
13.12 2項ビット単位演算子
構文
13.12.1 実行時意味論：評価
13.13 2項論理演算子
構文
&& または ||
演算子によって生成される値は、必ずしもBoolean型とは限りません。生成される値は常に2つのオペランド式のいずれかの値になります。
13.13.1 実行時意味論：評価
- lRef を
LogicalANDExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 ToBoolean (lVal) がfalse の場合、lVal を返す。- rRef を
BitwiseORExpression の ?Evaluation とする。 - ?
GetValue (rRef) を返す。
- lRef を
LogicalORExpression の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 ToBoolean (lVal) がtrue の場合、lVal を返す。- rRef を
LogicalANDExpression の ?Evaluation とする。 - ?
GetValue (rRef) を返す。
- lRef を
CoalesceExpressionHead の ?Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - lVal が
undefined またはnull の場合、- rRef を
BitwiseORExpression の ?Evaluation とする。 - ?
GetValue (rRef) を返す。
- rRef を
- それ以外の場合、
- lVal を返す。
13.14 条件演算子 ( ? : )
構文
ECMAScriptにおける
13.14.1 実行時意味論：評価
- lRef を
ShortCircuitExpression の ?Evaluation とする。 - lVal を
ToBoolean (?GetValue (lRef)) とする。 - lVal が
true の場合、- trueRef を 1番目の
AssignmentExpression の ?Evaluation とする。 - ?
GetValue (trueRef) を返す。
- trueRef を 1番目の
- それ以外の場合、
- falseRef を 2番目の
AssignmentExpression の ?Evaluation とする。 - ?
GetValue (falseRef) を返す。
- falseRef を 2番目の
13.15 代入演算子
構文
13.15.1 静的セマンティクス：早期エラー
-
LeftHandSideExpression がObjectLiteral またはArrayLiteral のいずれかである場合、LeftHandSideExpression はAssignmentPatternをカバーしなければならない 。 -
LeftHandSideExpression がObjectLiteral でもArrayLiteral でもない場合、LeftHandSideExpression のAssignmentTargetType がinvalid である場合は構文エラーとなる。
-
LeftHandSideExpression のAssignmentTargetType がinvalid である場合は構文エラーとなる。
-
LeftHandSideExpression のAssignmentTargetType がsimple でない場合は構文エラーとなる。
13.15.2 実行時意味論：評価
LeftHandSideExpression がObjectLiteral でもArrayLiteral でもない場合、- lRef を
LeftHandSideExpression の ?Evaluation とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat の場合、ReferenceError 例外をスローする。IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue かつIsIdentifierRef ofLeftHandSideExpression がtrue である場合、- lhs を
LeftHandSideExpression のStringValue とする。 - rVal を
AssignmentExpression のNamedEvaluation （引数 lhs）の結果とする。
- lhs を
- それ以外の場合、
- rRef を
AssignmentExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef).
- rRef を
-
?
PutValue (lRef, rVal) を実行する。 - rVal を返す。
- lRef を
- assignmentPattern を
AssignmentPattern で、LeftHandSideExpression にカバーされている ものとする。 - rRef を
AssignmentExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - ?
DestructuringAssignmentEvaluation （assignmentPattern，引数 rVal）を実行する。 - rVal を返す。
- lRef を
LeftHandSideExpression の ?Evaluation とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat の場合、ReferenceError 例外をスローする。- lVal を
?
GetValue (lRef) とする。 - rRef を
AssignmentExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - assignmentOpText を
AssignmentOperator がマッチしたソーステキスト とする。 - opText を次の表において assignmentOpText に対応するUnicodeコードポイントの列とする：
assignmentOpText opText **=***=*/=/%=%+=+-=-<<=<<>>=>>>>>=>>>&=&^=^|=| - r を lVal, opText, rVal を引数として
?
ApplyStringOrNumericBinaryOperator を呼ぶ。 - ?
PutValue (lRef, r) を実行する。 - r を返す。
- lRef を
LeftHandSideExpression の ?Evaluation とする。 - lVal を
?
GetValue (lRef) とする。 ToBoolean (lVal) がfalse の場合、lVal を返す。IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue かつIsIdentifierRef ofLeftHandSideExpression がtrue である場合、- lhs を
LeftHandSideExpression のStringValue とする。 - rVal を
AssignmentExpression のNamedEvaluation （引数 lhs）の結果とする。
- lhs を
- それ以外の場合、
- rRef を
AssignmentExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。
- rRef を
- ?
PutValue (lRef, rVal) を実行する。 - rVal を返す。
- lRef を
LeftHandSideExpression の ?Evaluation とする。 - lVal を
?
GetValue (lRef) とする。 ToBoolean (lVal) がtrue の場合、lVal を返す。IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue かつIsIdentifierRef ofLeftHandSideExpression がtrue である場合、- lhs を
LeftHandSideExpression のStringValue とする。 - rVal を
AssignmentExpression のNamedEvaluation （引数 lhs）の結果とする。
- lhs を
- それ以外の場合、
- rRef を
AssignmentExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。
- rRef を
- ?
PutValue (lRef, rVal) を実行する。 - rVal を返す。
- lRef を
LeftHandSideExpression の ?Evaluation とする。 - lVal を
?
GetValue (lRef) とする。 - lVal が
undefined でもnull でもない場合、lVal を返す。 IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue かつIsIdentifierRef ofLeftHandSideExpression がtrue である場合、- lhs を
LeftHandSideExpression のStringValue とする。 - rVal を
AssignmentExpression のNamedEvaluation （引数 lhs）の結果とする。
- lhs を
- それ以外の場合、
- rRef を
AssignmentExpression の ?Evaluation とする。 - rVal を ?
GetValue (rRef) とする。
- rRef を
- ?
PutValue (lRef, rVal) を実行する。 - rVal を返す。
13.15.3 ApplyStringOrNumericBinaryOperator ( lVal, opText, rVal )
抽象操作 ApplyStringOrNumericBinaryOperator は、引数 lVal（**、*、/、%、+、-、<<、>>、>>>、&、^、または
|）、および rVal（
- opText が
+の場合、- lPrim を ?
ToPrimitive (lVal) とする。 - rPrim を ?
ToPrimitive (rVal) とする。 - lPrim が
String であるか、rPrim がString である場合、- lStr を ?
ToString (lPrim) とする。 - rStr を ?
ToString (rPrim) とする。 - lStr と rStr の
string-concatenation を返す。
- lStr を ?
- lVal に lPrim を設定する。
- rVal に rPrim を設定する。
- lPrim を ?
- 注：ここで、必ず数値演算になる。
- lNum を ?
ToNumeric (lVal) とする。 - rNum を ?
ToNumeric (rVal) とする。 SameType (lNum, rNum) がfalse の場合、TypeError 例外をスローする。- lNum が
BigInt の場合、- opText が
**の場合、?BigInt::exponentiate (lNum, rNum) を返す。 - opText が
/の場合、?BigInt::divide (lNum, rNum) を返す。 - opText が
%の場合、?BigInt::remainder (lNum, rNum) を返す。 - opText が
>>>の場合、?BigInt::unsignedRightShift (lNum, rNum) を返す。 - operation を、次の表において opText に対応する抽象操作とする：
opText operation *BigInt::multiply +BigInt::add -BigInt::subtract <<BigInt::leftShift >>BigInt::signedRightShift &BigInt::bitwiseAND ^BigInt::bitwiseXOR |BigInt::bitwiseOR
- opText が
- それ以外の場合、
アサート : lNum はNumber である。- operation を、次の表において opText に対応する抽象操作とする：
opText operation **Number::exponentiate *Number::multiply /Number::divide %Number::remainder +Number::add -Number::subtract <<Number::leftShift >>Number::signedRightShift >>>Number::unsignedRightShift &Number::bitwiseAND ^Number::bitwiseXOR |Number::bitwiseOR
- operation(lNum, rNum) を返す。
ステップ
ステップ
13.15.4 EvaluateStringOrNumericBinaryExpression ( leftOperand, opText, rightOperand )
抽象操作 EvaluateStringOrNumericBinaryExpression は、leftOperand（
- lRef を leftOperand の ?
Evaluation とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を rightOperand の ?
Evaluation とする。 - rVal を ?
GetValue (rRef) とする。 - ?
ApplyStringOrNumericBinaryOperator (lVal, opText, rVal) を返す。
13.15.5 分割代入
補助構文
以下の生成規則のインスタンスを処理する際、特定の状況下では
13.15.5.1 静的セマンティクス：早期エラー
-
IdentifierReference のAssignmentTargetType がsimple でない場合、構文エラーとなる。
-
DestructuringAssignmentTarget がArrayLiteral またはObjectLiteral のいずれかである場合、構文エラーとなる。
-
LeftHandSideExpression がObjectLiteral またはArrayLiteral のいずれかである場合、LeftHandSideExpression はAssignmentPatternをカバーしなければならない 。 -
LeftHandSideExpression がObjectLiteral でもArrayLiteral でもない場合、LeftHandSideExpression のAssignmentTargetType がsimple でない場合、構文エラーとなる。
13.15.5.2 実行時意味論：DestructuringAssignmentEvaluation
- ?
RequireObjectCoercible (value) を実行する。 unused を返す。
- ?
RequireObjectCoercible (value) を実行する。 - ?
PropertyDestructuringAssignmentEvaluation をAssignmentPropertyList と引数 value で実行する。 unused を返す。
- ?
RequireObjectCoercible (value) を実行する。 - excludedNames を空の新しい
List とする。 - ?
RestDestructuringAssignmentEvaluation をAssignmentRestProperty 、引数 value および excludedNames で実行した結果を返す。
- ?
RequireObjectCoercible (value) を実行する。 - excludedNames を ?
PropertyDestructuringAssignmentEvaluation をAssignmentPropertyList 、引数 value で実行した結果とする。 - ?
RestDestructuringAssignmentEvaluation をAssignmentRestProperty 、引数 value および excludedNames で実行した結果を返す。
- iteratorRecord を ?
GetIterator (value,sync ) とする。 - ?
IteratorClose (iteratorRecord,NormalCompletion (unused )) を返す。
- iteratorRecord を ?
GetIterator (value,sync ) とする。 - result を
Completion (IteratorDestructuringAssignmentEvaluation をElision 、引数 iteratorRecord で実行) とする。 - iteratorRecord.[[Done]] が
false であれば、?IteratorClose (iteratorRecord, result) を返す。 - result を返す。
- iteratorRecord を ?
GetIterator (value,sync ) とする。 Elision が存在する場合、- status を
Completion (IteratorDestructuringAssignmentEvaluation をElision 、引数 iteratorRecord で実行) とする。 - status が
abrupt completion であれば、アサート : iteratorRecord.[[Done]] はtrue である。- ? status を返す。
- status を
- result を
Completion (IteratorDestructuringAssignmentEvaluation をAssignmentRestElement 、引数 iteratorRecord で実行) とする。 - iteratorRecord.[[Done]] が
false であれば、?IteratorClose (iteratorRecord, result) を返す。 - result を返す。
- iteratorRecord を ?
GetIterator (value,sync ) とする。 - result を
Completion (IteratorDestructuringAssignmentEvaluation をAssignmentElementList 、引数 iteratorRecord で実行) とする。 - iteratorRecord.[[Done]] が
false であれば、?IteratorClose (iteratorRecord, result) を返す。 - result を返す。
- iteratorRecord を ?
GetIterator (value,sync ) とする。 - status を
Completion (IteratorDestructuringAssignmentEvaluation をAssignmentElementList 、引数 iteratorRecord で実行) とする。 - status が
abrupt completion であれば、- iteratorRecord.[[Done]] が
false であれば、?IteratorClose (iteratorRecord, status) を返す。 - ? status を返す。
- iteratorRecord.[[Done]] が
Elision が存在する場合、- status に
Completion (IteratorDestructuringAssignmentEvaluation をElision 、引数 iteratorRecord で実行) を設定する。 - status が
abrupt completion であれば、アサート : iteratorRecord.[[Done]] はtrue である。- ? status を返す。
- status に
AssignmentRestElement が存在する場合、- status に
Completion (IteratorDestructuringAssignmentEvaluation をAssignmentRestElement 、引数 iteratorRecord で実行) を設定する。
- status に
- iteratorRecord.[[Done]] が
false であれば、?IteratorClose (iteratorRecord, status) を返す。 - ? status を返す。
13.15.5.3 実行時意味論: PropertyDestructuringAssignmentEvaluation
- propertyNames を ?
PropertyDestructuringAssignmentEvaluation （AssignmentPropertyList 、引数 value）の結果とする。 - nextNames を ?
PropertyDestructuringAssignmentEvaluation （AssignmentProperty 、引数 value）の結果とする。 - propertyNames と nextNames の
リスト連結 を返す。
- P を
IdentifierReference のStringValue とする。 - lRef を ?
ResolveBinding (P) とする。 - v を ?
GetV (value, P) とする。 Initializer が存在し、かつ v がundefined の場合、IsAnonymousFunctionDefinition (Initializer ) がtrue の場合、- v を ?
NamedEvaluation （Initializer 、引数 P）の結果に設定する。
- v を ?
- それ以外の場合、
- defaultValue を ?
Evaluation (Initializer ) とする。 - v を ?
GetValue (defaultValue) に設定する。
- defaultValue を ?
- ?
PutValue (lRef, v) を実行する。 - « P » を返す。
- name を ?
Evaluation (PropertyName ) とする。 - ?
KeyedDestructuringAssignmentEvaluation （AssignmentElement 、引数 value、name）を実行する。 - « name » を返す。
13.15.5.4 実行時意味論: RestDestructuringAssignmentEvaluation
- lRef を
DestructuringAssignmentTarget の ?Evaluation とする。 - restObj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - ?
CopyDataProperties (restObj, value, excludedNames) を実行する。 - ?
PutValue (lRef, restObj) を返す。
13.15.5.5 実行時意味論: IteratorDestructuringAssignmentEvaluation
- ?
IteratorDestructuringAssignmentEvaluation をAssignmentElisionElement 、引数 iteratorRecord で実行し、その結果を返す。
- ?
IteratorDestructuringAssignmentEvaluation をAssignmentElementList 、引数 iteratorRecord で実行する。 - ?
IteratorDestructuringAssignmentEvaluation をAssignmentElisionElement 、引数 iteratorRecord で実行し、その結果を返す。
- ?
IteratorDestructuringAssignmentEvaluation をAssignmentElement 、引数 iteratorRecord で実行し、その結果を返す。
- ?
IteratorDestructuringAssignmentEvaluation をElision 、引数 iteratorRecord で実行する。 - ?
IteratorDestructuringAssignmentEvaluation をAssignmentElement 、引数 iteratorRecord で実行し、その結果を返す。
- iteratorRecord.[[Done]] が
false の場合、- ?
IteratorStep (iteratorRecord) を実行する。
- ?
unused を返す。
- ?
IteratorDestructuringAssignmentEvaluation をElision 、引数 iteratorRecord で実行する。 - iteratorRecord.[[Done]] が
false の場合、- ?
IteratorStep (iteratorRecord) を実行する。
- ?
unused を返す。
DestructuringAssignmentTarget がObjectLiteral でもArrayLiteral でもない場合、- lRef を
DestructuringAssignmentTarget の ?Evaluation とする。
- lRef を
- value を
undefined とする。 - iteratorRecord.[[Done]] が
false の場合、- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done でない場合、- value を next に設定する。
- next を ?
Initializer が存在し、かつ value がundefined の場合、IsAnonymousFunctionDefinition (Initializer ) がtrue で、かつIsIdentifierRef ofDestructuringAssignmentTarget がtrue の場合、- target を
DestructuringAssignmentTarget のStringValue とする。 - v を
Initializer の ?NamedEvaluation （引数 target）の結果に設定する。
- target を
- それ以外の場合、
- defaultValue を
Initializer の ?Evaluation とする。 - v を ?
GetValue (defaultValue) に設定する。
- defaultValue を
- それ以外の場合、
- v を value に設定する。
DestructuringAssignmentTarget がObjectLiteral またはArrayLiteral のいずれかである場合、- nestedAssignmentPattern を
DestructuringAssignmentTarget にカバーされている AssignmentPattern とする。 - ?
DestructuringAssignmentEvaluation （nestedAssignmentPattern，引数 v）の結果を返す。
- nestedAssignmentPattern を
- ?
PutValue (lRef, v) を返す。
左から右への評価順序は、分割代入パターンでない
DestructuringAssignmentTarget がObjectLiteral でもArrayLiteral でもない場合、- lRef を
DestructuringAssignmentTarget の ?Evaluation とする。
- lRef を
- A を !
ArrayCreate (0) とする。 - n を 0 とする。
- iteratorRecord.[[Done]] が
false の間、繰り返す：- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done でない場合、- !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), next) を実行する。 - n を n + 1 に設定する。
- !
- next を ?
DestructuringAssignmentTarget がObjectLiteral でもArrayLiteral でもない場合、- ?
PutValue (lRef, A) を返す。
- ?
- nestedAssignmentPattern を
DestructuringAssignmentTarget にカバーされている AssignmentPattern とする。 - ?
DestructuringAssignmentEvaluation （nestedAssignmentPattern，引数 A）の結果を返す。
13.15.5.6 実行時意味論: KeyedDestructuringAssignmentEvaluation
DestructuringAssignmentTarget がObjectLiteral でもArrayLiteral でもない場合、- lRef を
DestructuringAssignmentTarget の ?Evaluation とする。
- lRef を
- v を ?
GetV (value, propertyName) とする。 Initializer が存在し、かつ v がundefined の場合、IsAnonymousFunctionDefinition (Initializer ) がtrue で、かつIsIdentifierRef ofDestructuringAssignmentTarget がtrue の場合、- target を
DestructuringAssignmentTarget のStringValue とする。 - rhsValue を
Initializer の ?NamedEvaluation （引数 target）の結果に設定する。
- target を
- それ以外の場合、
- defaultValue を
Initializer の ?Evaluation とする。 - rhsValue を ?
GetValue (defaultValue) に設定する。
- defaultValue を
- それ以外の場合、
- rhsValue を v に設定する。
DestructuringAssignmentTarget がObjectLiteral またはArrayLiteral のいずれかである場合、- assignmentPattern を
DestructuringAssignmentTarget にカバーされている AssignmentPattern とする。 - ?
DestructuringAssignmentEvaluation （assignmentPattern，引数 rhsValue）の結果を返す。
- assignmentPattern を
- ?
PutValue (lRef, rhsValue) を返す。
13.16 カンマ演算子（,）
構文
13.16.1 実行時意味論：評価
- lRef を
Expression の ?Evaluation とする。 - ?
GetValue (lRef) を実行する。 - rRef を
AssignmentExpression の ?Evaluation とする。 - ?
GetValue (rRef) を返す。
14 ECMAScript 言語：文および宣言
構文
14.1 文の意味論
14.1.1 実行時意味論：評価
empty を返す。
- ?
Evaluation （FunctionDeclaration ）を返す。
- newLabelSet を空の新しい
List とする。 - ?
LabelledEvaluation （このBreakableStatement ，引数 newLabelSet）を返す。
14.2 ブロック
構文
14.2.1 静的セマンティクス：早期エラー
-
StatementList のLexicallyDeclaredNames に重複した要素が含まれている場合、構文エラーとなる。 -
StatementList のLexicallyDeclaredNames のいずれかの要素がStatementList のVarDeclaredNames にも含まれている場合、構文エラーとなる。
14.2.2 実行時意味論：評価
empty を返す。
- oldEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - blockEnv を
NewDeclarativeEnvironment (oldEnv) とする。 BlockDeclarationInstantiation （StatementList ，blockEnv）を実行する。実行中の実行コンテキスト の LexicalEnvironment を blockEnv に設定する。- blockValue を
Completion （Evaluation （StatementList ））とする。 実行中の実行コンテキスト の LexicalEnvironment を oldEnv に設定する。- ? blockValue を返す。
制御が
- sl を
StatementList の ?Evaluation とする。 - s を
Completion （StatementListItem のEvaluation ）とする。 - ?
UpdateEmpty (s, sl) を返す。
eval 関数の呼び出しはすべて値 1 を返す：
eval("1;;;;;")
eval("1;{}")
eval("1;var a;")14.2.3 BlockDeclarationInstantiation ( code, env )
抽象操作 BlockDeclarationInstantiation は、引数 code（
呼び出されたとき、次の手順を実行する：
- declarations を code の
LexicallyScopedDeclarations とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - declarations の各要素 d について、
- d の
BoundNames の各要素 dn について、IsConstantDeclaration （d）がtrue である場合、- ! env.CreateImmutableBinding(dn,
true ) を実行する。
- ! env.CreateImmutableBinding(dn,
- それ以外の場合、
-
! env.CreateMutableBinding(dn,
false ) を実行する。注：このステップはB.3.2.6 で置き換えられる。
-
! env.CreateMutableBinding(dn,
- d が
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである場合、- fn を d の
BoundNames の唯一の要素とする。 - fo を
InstantiateFunctionObject （d，引数 env および privateEnv）の結果とする。 -
! env.InitializeBinding(fn, fo)
を実行する。注：このステップは
B.3.2.6 で置き換えられる。
- fn を d の
- d の
unused を返す。
14.3 宣言と変数文
14.3.1 let および const 宣言
let および const 宣言は、let 宣言内の
構文
14.3.1.1 静的セマンティクス：早期エラー
-
BindingList のBoundNames に"let" が含まれている場合、構文エラーとなる。 -
BindingList のBoundNames に重複した要素が含まれている場合、構文エラーとなる。
-
LexicalDeclaration に含まれるこのLexicalBinding について、Initializer が存在せず、かつIsConstantDeclaration がtrue の場合、構文エラーとなる。
14.3.1.2 実行時意味論：評価
- ?
Evaluation （BindingList ）を実行する。 empty を返す。
- ?
Evaluation （BindingList ）を実行する。 - ?
Evaluation （LexicalBinding ）を返す。
- lhs を !
ResolveBinding （StringValue （BindingIdentifier ））とする。 - !
InitializeReferencedBinding （lhs，undefined ）を実行する。 empty を返す。
const 宣言で現れることはない。
- bindingId を
BindingIdentifier のStringValue とする。 - lhs を !
ResolveBinding （bindingId）とする。 IsAnonymousFunctionDefinition （Initializer ）がtrue の場合、- value を ?
NamedEvaluation （Initializer ，引数 bindingId）とする。
- value を ?
- それ以外の場合、
- rhs を ?
Evaluation （Initializer ）とする。 - value を ?
GetValue （rhs）とする。
- rhs を ?
- !
InitializeReferencedBinding （lhs，value）を実行する。 empty を返す。
- rhs を ?
Evaluation （Initializer ）とする。 - value を ?
GetValue （rhs）とする。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - ?
BindingInitialization （BindingPattern ，引数 value および env）を返す。
14.3.2 変数文
var 文は、
構文
14.3.2.1 実行時意味論：評価
- ?
Evaluation （VariableDeclarationList ）を実行する。 empty を返す。
- ?
Evaluation （VariableDeclarationList ）を実行する。 - ?
Evaluation （VariableDeclaration ）を返す。
empty を返す。
- bindingId を
BindingIdentifier のStringValue とする。 - lhs を ?
ResolveBinding （bindingId）とする。 IsAnonymousFunctionDefinition （Initializer ）がtrue の場合、- value を ?
NamedEvaluation （Initializer ，引数 bindingId）とする。
- value を ?
- それ以外の場合、
- rhs を ?
Evaluation （Initializer ）とする。 - value を ?
GetValue （rhs）とする。
- rhs を ?
- ?
PutValue （lhs，value）を実行する。 empty を返す。
- rhs を ?
Evaluation （Initializer ）とする。 - rVal を ?
GetValue （rhs）とする。 - ?
BindingInitialization （BindingPattern ，引数 rVal およびundefined ）を返す。
14.3.3 分割代入バインディングパターン
構文
14.3.3.1 実行時意味論：PropertyBindingInitialization
- boundNames を ?
PropertyBindingInitialization （BindingPropertyList ，引数 value および environment）の結果とする。 - nextNames を ?
PropertyBindingInitialization （BindingProperty ，引数 value および environment）の結果とする。 - boundNames と nextNames の
リスト連結 を返す。
- name を
SingleNameBinding のBoundNames の唯一の要素とする。 - ?
KeyedBindingInitialization （SingleNameBinding ，引数 value、environment、name）を実行する。 - « name » を返す。
- P を ?
Evaluation （PropertyName ）の結果とする。 - ?
KeyedBindingInitialization （BindingElement ，引数 value、environment、P）を実行する。 - « P » を返す。
14.3.3.2 実行時意味論：RestBindingInitialization
- lhs を ?
ResolveBinding （StringValue （BindingIdentifier ），environment）の結果とする。 - restObj を
OrdinaryObjectCreate （%Object.prototype% ）とする。 - ?
CopyDataProperties （restObj，value，excludedNames）を実行する。 - environment が
undefined の場合、?PutValue （lhs，restObj）を返す。 - ?
InitializeReferencedBinding （lhs，restObj）を返す。
14.3.3.3 実行時意味論：KeyedBindingInitialization
environment に
これは以下の生成規則ごとに定義される：
- v を ?
GetV （value，propertyName）の結果とする。 Initializer が存在し、かつ v がundefined の場合、- defaultValue を ?
Evaluation （Initializer ）の結果とする。 - v を ?
GetValue （defaultValue）の結果に設定する。
- defaultValue を ?
- ?
BindingInitialization （BindingPattern ，引数 v および environment）を返す。
- bindingId を
BindingIdentifier のStringValue とする。 - lhs を ?
ResolveBinding （bindingId，environment）の結果とする。 - v を ?
GetV （value，propertyName）の結果とする。 Initializer が存在し、かつ v がundefined の場合、IsAnonymousFunctionDefinition （Initializer ）がtrue の場合、- v を ?
NamedEvaluation （Initializer ，引数 bindingId）の結果に設定する。
- v を ?
- それ以外の場合、
- defaultValue を ?
Evaluation （Initializer ）の結果とする。 - v を ?
GetValue （defaultValue）の結果に設定する。
- defaultValue を ?
- environment が
undefined の場合、?PutValue （lhs，v）を返す。 - ?
InitializeReferencedBinding （lhs，v）を返す。
14.4 空文
構文
14.4.1 実行時意味論：評価
empty を返す。
14.5 式文
構文
function または class async function で始めることはできない。これは let [ という 2 トークンの並びで始めることはできない。これは let と曖昧になるためである。
14.5.1 実行時意味論：評価
- exprRef を
Expression の ?Evaluation とする。 - ?
GetValue （exprRef）を返す。
14.6 if 文
構文
else] は、古典的な「ぶら下がり
else」問題を通常の方法で解決する。つまり、どの if に対応するか曖昧な場合、else は候補となる if
のうち最も内側（最も近い）ものに関連付けられる。
14.6.1 静的セマンティクス：早期エラー
-
最初の
Statement に対してIsLabelledFunction がtrue の場合、構文エラーとなる。 -
2番目の
Statement に対してIsLabelledFunction がtrue の場合、構文エラーとなる。
-
Statement に対してIsLabelledFunction がtrue の場合、構文エラーとなる。
この規則は
14.6.2 実行時意味論：評価
- exprRef を
Expression の ?Evaluation とする。 - exprValue を
ToBoolean (?GetValue (exprRef)) とする。 - exprValue が
true の場合、- stmtCompletion を
Completion (Evaluation （最初のStatement ）) とする。
- stmtCompletion を
- それ以外の場合、
- stmtCompletion を
Completion (Evaluation （2番目のStatement ）) とする。
- stmtCompletion を
- ?
UpdateEmpty （stmtCompletion，undefined ）を返す。
- exprRef を
Expression の ?Evaluation とする。 - exprValue を
ToBoolean (?GetValue (exprRef)) とする。 - exprValue が
false の場合、undefined を返す。
- それ以外の場合、
- stmtCompletion を
Completion (Evaluation （Statement ）) とする。 - ?
UpdateEmpty （stmtCompletion，undefined ）を返す。
- stmtCompletion を
14.7 反復文
構文
14.7.1 意味論
14.7.1.1 LoopContinues ( completion, labelSet )
抽象操作 LoopContinues は、引数 completion（
- completion が
normal completion である場合、true を返す。 - completion が
continue completion でない場合、false を返す。 - completion.[[Target]] が
empty の場合、true を返す。 - labelSet が completion.[[Target]]
を含む場合、
true を返す。 false を返す。
14.7.1.2 実行時意味論：LoopEvaluation
- ?
DoWhileLoopEvaluation （DoWhileStatement ，引数 labelSet）を返す。
- ?
WhileLoopEvaluation （WhileStatement ，引数 labelSet）を返す。
- ?
ForLoopEvaluation （ForStatement ，引数 labelSet）を返す。
- ?
ForInOfLoopEvaluation （ForInOfStatement ，引数 labelSet）を返す。
14.7.2 do-while 文
構文
14.7.2.1 静的セマンティクス：早期エラー
-
IsLabelledFunction (Statement ) がtrue の場合、構文エラーとなる。
この規則は
14.7.2.2 実行時意味論：DoWhileLoopEvaluation
- V を
undefined とする。 - 繰り返す、
- stmtResult を
Completion (Evaluation （Statement ）) とする。 LoopContinues (stmtResult, labelSet) がfalse の場合、?UpdateEmpty (stmtResult, V) を返す。- stmtResult.[[Value]] が
empty でない場合、V を stmtResult.[[Value]] に設定する。 - exprRef を
Expression の ?Evaluation とする。 - exprValue を ?
GetValue (exprRef) とする。 ToBoolean (exprValue) がfalse の場合、V を返す。
- stmtResult を
14.7.3 while 文
構文
14.7.3.1 静的セマンティクス：早期エラー
-
IsLabelledFunction (Statement ) がtrue の場合、構文エラーとなる。
この規則は
14.7.3.2 実行時意味論：WhileLoopEvaluation
- V を
undefined とする。 - 繰り返す、
- exprRef を
Expression の ?Evaluation とする。 - exprValue を ?
GetValue (exprRef) とする。 ToBoolean (exprValue) がfalse の場合、V を返す。- stmtResult を
Completion (Evaluation （Statement ）) とする。 LoopContinues (stmtResult, labelSet) がfalse の場合、?UpdateEmpty (stmtResult, V) を返す。- stmtResult.[[Value]] が
empty でない場合、V を stmtResult.[[Value]] に設定する。
- exprRef を
14.7.4 for 文
構文
14.7.4.1 静的セマンティクス：早期エラー
-
IsLabelledFunction (Statement ) がtrue の場合、構文エラーとなる。
この規則は
-
LexicalDeclaration のBoundNames のいずれかの要素がStatement のVarDeclaredNames にも含まれている場合、構文エラーとなる。
14.7.4.2 実行時意味論：ForLoopEvaluation
- 最初の
Expression が存在する場合、- exprRef を 最初の
Expression の ?Evaluation とする。 - ?
GetValue （exprRef）を実行する。
- exprRef を 最初の
- 2番目の
Expression が存在する場合、test を 2番目のExpression とし、そうでなければ test をempty とする。 - 3番目の
Expression が存在する場合、increment を 3番目のExpression とし、そうでなければ increment をempty とする。 - ?
ForBodyEvaluation （test，increment，Statement ，« »，labelSet）を返す。
- ?
Evaluation （VariableDeclarationList ）を実行する。 - 最初の
Expression が存在する場合、test を最初のExpression とし、そうでなければ test をempty とする。 - 2番目の
Expression が存在する場合、increment を2番目のExpression とし、そうでなければ increment をempty とする。 - ?
ForBodyEvaluation （test，increment，Statement ，« »，labelSet）を返す。
- oldEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - loopEnv を
NewDeclarativeEnvironment （oldEnv）とする。 - isConst を
LexicalDeclaration のIsConstantDeclaration とする。 - boundNames を
LexicalDeclaration のBoundNames とする。 - boundNames の各要素 dn について、
- isConst が
true の場合、- ! loopEnv.CreateImmutableBinding(dn，
true ) を実行する。
- ! loopEnv.CreateImmutableBinding(dn，
- それ以外の場合、
- ! loopEnv.CreateMutableBinding(dn，
false ) を実行する。
- ! loopEnv.CreateMutableBinding(dn，
- isConst が
実行中の実行コンテキスト の LexicalEnvironment を loopEnv に設定する。- forDcl を
Completion (Evaluation （LexicalDeclaration ）) とする。 - forDcl が
abrupt completion の場合、実行中の実行コンテキスト の LexicalEnvironment を oldEnv に設定する。- ? forDcl を返す。
- isConst が
false の場合、perIterationLets を boundNames とし、そうでなければ perIterationLets を空の新しいList とする。 - 最初の
Expression が存在する場合、test を最初のExpression とし、そうでなければ test をempty とする。 - 2番目の
Expression が存在する場合、increment を2番目のExpression とし、そうでなければ increment をempty とする。 - bodyResult を
Completion (ForBodyEvaluation (test，increment，Statement ，perIterationLets，labelSet)) とする。 実行中の実行コンテキスト の LexicalEnvironment を oldEnv に設定する。- ? bodyResult を返す。
14.7.4.3 ForBodyEvaluation ( test, increment, stmt, perIterationBindings, labelSet )
抽象操作 ForBodyEvaluation は、引数 test（
- V を
undefined とする。 - ?
CreatePerIterationEnvironment （perIterationBindings）を実行する。 - 繰り返す、
- test が
empty でない場合、- testRef を test の ?
Evaluation とする。 - testValue を ?
GetValue （testRef）とする。 ToBoolean （testValue）がfalse の場合、V を返す。
- testRef を test の ?
- result を stmt の
Completion (Evaluation ) とする。 LoopContinues （result，labelSet）がfalse の場合、?UpdateEmpty （result，V）を返す。- result.[[Value]] が
empty でない場合、V を result.[[Value]] に設定する。 - ?
CreatePerIterationEnvironment （perIterationBindings）を実行する。 - increment が
empty でない場合、- incRef を increment の ?
Evaluation とする。 - ?
GetValue （incRef）を実行する。
- incRef を increment の ?
- test が
14.7.4.4 CreatePerIterationEnvironment ( perIterationBindings )
抽象操作 CreatePerIterationEnvironment は、引数 perIterationBindings（
- perIterationBindings に要素がある場合、
- lastIterationEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - outer を lastIterationEnv.[[OuterEnv]] とする。
アサート ：outer はnull ではない。- thisIterationEnv を
NewDeclarativeEnvironment （outer）とする。 - perIterationBindings の各要素 bn について、
- ! thisIterationEnv.CreateMutableBinding(bn，
false ) を実行する。 - lastValue を
? lastIterationEnv.GetBindingValue(bn，
true ) とする。 - ! thisIterationEnv.InitializeBinding(bn，lastValue) を実行する。
- ! thisIterationEnv.CreateMutableBinding(bn，
実行中の実行コンテキスト の LexicalEnvironment を thisIterationEnv に設定する。
- lastIterationEnv を
unused を返す。
14.7.5
for-in、for-of、および
for-await-of 文
構文
このセクションは附属書
14.7.5.1 静的セマンティクス：早期エラー
-
IsLabelledFunction （Statement ）がtrue の場合、構文エラーとなる。
この規則は
-
LeftHandSideExpression がObjectLiteral またはArrayLiteral のいずれかである場合、LeftHandSideExpression はAssignmentPattern をカバー しなければならない。 -
LeftHandSideExpression がObjectLiteral でもArrayLiteral でもない場合、LeftHandSideExpression のAssignmentTargetType がinvalid であれば構文エラーとなる。
-
ForDeclaration のBoundNames に"let" が含まれている場合、構文エラーとなる。 -
ForDeclaration のBoundNames のいずれかの要素がStatement のVarDeclaredNames にも含まれている場合、構文エラーとなる。 -
ForDeclaration のBoundNames に重複する要素が含まれている場合、構文エラーとなる。
14.7.5.2 静的セマンティクス：IsDestructuring
PrimaryExpression がObjectLiteral またはArrayLiteral のいずれかである場合、true を返す。false を返す。
false を返す。
false を返す。
true を返す。
このセクションは附属書
14.7.5.3 実行時意味論：ForDeclarationBindingInitialization
environment に var 文や一部の
これは次の生成規則ごとに定義される：
- ?
BindingInitialization （ForBinding ，引数 value および environment）を返す。
14.7.5.4 実行時意味論：ForDeclarationBindingInstantiation
ForBinding のBoundNames の各要素 name について、LetOrConst のIsConstantDeclaration がtrue の場合、- ! environment.CreateImmutableBinding(name，
true ) を実行する。
- ! environment.CreateImmutableBinding(name，
- それ以外の場合、
- ! environment.CreateMutableBinding(name，
false ) を実行する。
- ! environment.CreateMutableBinding(name，
unused を返す。
14.7.5.5 実行時意味論：ForInOfLoopEvaluation
- keyResult を ?
ForIn/OfHeadEvaluation （« »,Expression ，enumerate ）とする。 - ?
ForIn/OfBodyEvaluation （LeftHandSideExpression ，Statement ，keyResult，enumerate ，assignment ，labelSet）を返す。
- keyResult を ?
ForIn/OfHeadEvaluation （« »,Expression ，enumerate ）とする。 - ?
ForIn/OfBodyEvaluation （ForBinding ，Statement ，keyResult，enumerate ，var-binding ，labelSet）を返す。
- keyResult を ?
ForIn/OfHeadEvaluation （BoundNames （ForDeclaration ），Expression ，enumerate ）とする。 - ?
ForIn/OfBodyEvaluation （ForDeclaration ，Statement ，keyResult，enumerate ，lexical-binding ，labelSet）を返す。
- keyResult を ?
ForIn/OfHeadEvaluation （« »,AssignmentExpression ，iterate ）とする。 - ?
ForIn/OfBodyEvaluation （LeftHandSideExpression ，Statement ，keyResult，iterate ，assignment ，labelSet）を返す。
- keyResult を ?
ForIn/OfHeadEvaluation （« »,AssignmentExpression ，iterate ）とする。 - ?
ForIn/OfBodyEvaluation （ForBinding ，Statement ，keyResult，iterate ，var-binding ，labelSet）を返す。
- keyResult を ?
ForIn/OfHeadEvaluation （BoundNames （ForDeclaration ），AssignmentExpression ，iterate ）とする。 - ?
ForIn/OfBodyEvaluation （ForDeclaration ，Statement ，keyResult，iterate ，lexical-binding ，labelSet）を返す。
- keyResult を ?
ForIn/OfHeadEvaluation （« »,AssignmentExpression ，async-iterate ）とする。 - ?
ForIn/OfBodyEvaluation （LeftHandSideExpression ，Statement ，keyResult，iterate ，assignment ，labelSet，async ）を返す。
- keyResult を ?
ForIn/OfHeadEvaluation （« »,AssignmentExpression ，async-iterate ）とする。 - ?
ForIn/OfBodyEvaluation （ForBinding ，Statement ，keyResult，iterate ，var-binding ，labelSet，async ）を返す。
- keyResult を ?
ForIn/OfHeadEvaluation （BoundNames （ForDeclaration ），AssignmentExpression ，async-iterate ）とする。 - ?
ForIn/OfBodyEvaluation （ForDeclaration ，Statement ，keyResult，iterate ，lexical-binding ，labelSet，async ）を返す。
このセクションは附属書
14.7.5.6 ForIn/OfHeadEvaluation ( uninitializedBoundNames, expr, iterationKind )
抽象操作 ForIn/OfHeadEvaluation は、引数 uninitializedBoundNames（
- oldEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - uninitializedBoundNames が空でない場合、
アサート ： uninitializedBoundNames に重複するエントリはない。- newEnv を
NewDeclarativeEnvironment （oldEnv）とする。 - uninitializedBoundNames の各文字列 name について、
- ! newEnv.CreateMutableBinding(name，
false ) を実行する。
- ! newEnv.CreateMutableBinding(name，
実行中の実行コンテキスト の LexicalEnvironment を newEnv に設定する。
- exprRef を
Completion (Evaluation （expr）) とする。 実行中の実行コンテキスト の LexicalEnvironment を oldEnv に設定する。- exprValue を ?
GetValue (? exprRef) とする。 - iterationKind が
enumerate の場合、- exprValue が
undefined またはnull のいずれかである場合、Completion Record { [[Type]]:break , [[Value]]:empty , [[Target]]:empty } を返す。
- obj を !
ToObject （exprValue）とする。 - iterator を
EnumerateObjectProperties （obj）とする。 - nextMethod を !
GetV （iterator，"next" ）とする。 Iterator Record { [[Iterator]]: iterator, [[NextMethod]]: nextMethod, [[Done]]:false } を返す。
- exprValue が
- それ以外の場合、
アサート ：iterationKind はiterate またはasync-iterate のいずれかである。- iterationKind が
async-iterate の場合、iteratorKind をasync とする。 - それ以外の場合、iteratorKind を
sync とする。 - ?
GetIterator （exprValue，iteratorKind）を返す。
14.7.5.7 ForIn/OfBodyEvaluation ( lhs, stmt, iteratorRecord, iterationKind, lhsKind, labelSet [ , iteratorKind ] )
抽象操作 ForIn/OfBodyEvaluation は、引数 lhs（
- iteratorKind が存在しない場合、iteratorKind を
sync に設定する。 - oldEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - V を
undefined とする。 - destructuring を
IsDestructuring （lhs）とする。 - destructuring が
true かつ lhsKind がassignment の場合、アサート ：lhs はLeftHandSideExpression である。- assignmentPattern を lhs によって
カバーされる AssignmentPattern とする。
- 繰り返す、
- nextResult を ?
Call （iteratorRecord.[[NextMethod]]，iteratorRecord.[[Iterator]]）とする。 - iteratorKind が
async の場合、nextResult を ?Await （nextResult）に設定する。 - nextResult が
オブジェクトでない 場合、TypeError 例外をスローする。 - done を ?
IteratorComplete （nextResult）とする。 - done が
true の場合、V を返す。 - nextValue を ?
IteratorValue （nextResult）とする。 - lhsKind が
assignment またはvar-binding のいずれかの場合、- destructuring が
true の場合、- lhsKind が
assignment の場合、- status を
Completion (DestructuringAssignmentEvaluation of assignmentPattern with argument nextValue) とする。
- status を
- それ以外の場合、
アサート ： lhsKind はvar-binding である。アサート ： lhs はForBinding である。- status を
Completion (BindingInitialization of lhs with arguments nextValue およびundefined ) とする。
- lhsKind が
- それ以外の場合、
- lhsRef を
Completion (Evaluation （lhs）) とする。（繰り返し評価されることがある） - lhsKind が
assignment かつ lhs のAssignmentTargetType がweb-compat である場合、ReferenceError 例外をスローする。 - lhsRef が
abrupt completion の場合、- status を lhsRef とする。
- それ以外の場合、
- status を
Completion (PutValue (lhsRef.[[Value]]， nextValue)) とする。
- status を
- lhsRef を
- destructuring が
- それ以外の場合、
アサート ：lhsKind はlexical-binding である。アサート ：lhs はForDeclaration である。- iterationEnv を
NewDeclarativeEnvironment （oldEnv）とする。 ForDeclarationBindingInstantiation （lhs，引数 iterationEnv）を実行する。実行中の実行コンテキスト の LexicalEnvironment を iterationEnv に設定する。- destructuring が
true の場合、- status を
Completion (ForDeclarationBindingInitialization of lhs with arguments nextValue および iterationEnv) とする。
- status を
- それ以外の場合、
アサート ：lhs は単一の名前を束縛する。- lhsName を
LetOrConst のBoundNames の唯一の要素とする。 - lhsRef を !
ResolveBinding （lhsName）とする。 - status を
Completion (InitializeReferencedBinding (lhsRef， nextValue)) とする。
- status が
abrupt completion の場合、実行中の実行コンテキスト の LexicalEnvironment を oldEnv に設定する。- iteratorKind が
async の場合、?AsyncIteratorClose （iteratorRecord，status）を返す。 - iterationKind が
enumerate の場合、- ? status を返す。
- それ以外の場合、
アサート ：iterationKind はiterate である。- ?
IteratorClose （iteratorRecord，status）を返す。
- result を
Completion (Evaluation （stmt）) とする。 実行中の実行コンテキスト の LexicalEnvironment を oldEnv に設定する。LoopContinues （result，labelSet）がfalse の場合、- iterationKind が
enumerate の場合、- ?
UpdateEmpty （result，V）を返す。
- ?
- それ以外の場合、
アサート ：iterationKind はiterate である。- status を
Completion (UpdateEmpty （result，V）) に設定する。 - iteratorKind が
async の場合、?AsyncIteratorClose （iteratorRecord，status）を返す。 - ?
IteratorClose （iteratorRecord，status）を返す。
- iterationKind が
- result.[[Value]] が
empty でない場合、V を result.[[Value]] に設定する。
- nextResult を ?
14.7.5.8 実行時意味論：評価
- bindingId を
BindingIdentifier のStringValue とする。 - ?
ResolveBinding （bindingId）を返す。
14.7.5.9 EnumerateObjectProperties ( O )
抽象操作 EnumerateObjectProperties は引数 O（オブジェクト）を受け取り、
- O の enumerable プロパティのすべての文字列値キーを反復する
nextメソッドを持つイテレータオブジェクト を返す。イテレータオブジェクト は ECMAScript コードから直接アクセスされることはない。プロパティの列挙の仕組みや順序は規定されていないが、以下に指定する規則に従う必要がある。
throw および
return メソッドは next
メソッドは、next
メソッドで処理される前に削除されたプロパティは無視される。列挙中に新しいプロパティが追加された場合、それらが列挙の対象になる保証はない。next
メソッドによって返される。
ターゲットオブジェクトのプロパティの列挙には、そのプロトタイプ、およびそのプロトタイプのプロトタイプといった具合に再帰的にプロトタイプのプロパティも含まれるが、プロトタイプのプロパティが、すでに
next
メソッドで処理されたものと同じ名前である場合、そのプロパティは処理されない。プロトタイプオブジェクトの enumerable プロパティ名は、そのプロトタイプオブジェクトを引数として
EnumerateObjectProperties を呼び出して取得しなければならない。EnumerateObjectProperties は、ターゲットオブジェクトの [[OwnPropertyKeys]] 内部メソッドを呼び出して、そのオブジェクト自身の
さらに、O およびそのプロトタイプチェーン上のいずれのオブジェクトも
- O またはプロトタイプチェーン上のオブジェクトの [[Prototype]] 内部スロットの値が変更された場合
- O またはプロトタイプチェーン上のオブジェクトのプロパティが削除された場合
- O のプロトタイプチェーン上のオブジェクトにプロパティが追加された場合
- O またはプロトタイプチェーン上のオブジェクトのプロパティの [[Enumerable]] 属性の値が変更された場合
ECMAScript 実装は
以下はこれらの規則に準拠する ECMAScript ジェネレータ関数の参考定義である：
function* EnumerateObjectProperties(obj) {
const visited = new Set();
for (const key of Reflect.ownKeys(obj)) {
if (typeof key === "symbol") continue;
const desc = Reflect.getOwnPropertyDescriptor(obj, key);
if (desc) {
visited.add(key);
if (desc.enumerable) yield key;
}
}
const proto = Reflect.getPrototypeOf(obj);
if (proto === null) return;
for (const protoKey of EnumerateObjectProperties(proto)) {
if (!visited.has(protoKey)) yield protoKey;
}
}14.7.5.10 for-in イテレータオブジェクト
For-In
イテレータ は、特定のオブジェクトの反復を表すオブジェクトである。For-In イテレータオブジェクトは ECMAScript
コードから直接アクセスされることはなく、
14.7.5.10.1 CreateForInIterator ( object )
抽象操作 CreateForInIterator は引数 object（オブジェクト）を受け取り、
- iterator を
OrdinaryObjectCreate （%ForInIteratorPrototype% ，« [[Object]], [[ObjectWasVisited]], [[VisitedKeys]], [[RemainingKeys]] »）とする。 - iterator.[[Object]] に object を設定する。
- iterator.[[ObjectWasVisited]] に
false を設定する。 - iterator.[[VisitedKeys]] に新しい空の
リスト を設定する。 - iterator.[[RemainingKeys]] に新しい空の
リスト を設定する。 - iterator を返す。
14.7.5.10.2 %ForInIteratorPrototype% オブジェクト
%ForInIteratorPrototype% オブジェクト：
- すべての
For-In イテレータオブジェクト が継承するプロパティを持つ。 通常のオブジェクト である。- [[Prototype]] 内部スロットの値は
%Iterator.prototype% である。 - ECMAScript コードから直接アクセスされることはない。
- 以下のプロパティを持つ：
14.7.5.10.2.1 %ForInIteratorPrototype%.next ( )
- O を
this とする。 アサート ：O はオブジェクトである 。アサート ：O はFor-In イテレータ インスタンスのすべての内部スロットを持つ（14.7.5.10.3 ）。- object を O.[[Object]] とする。
- 繰り返す、
- O.[[ObjectWasVisited]] が
false の場合、- keys を ? object.[[OwnPropertyKeys]]() とする。
- keys の各要素 key について、
- key が
文字列 の場合、- key を O.[[RemainingKeys]] に追加する。
- key が
- O.[[ObjectWasVisited]] に
true を設定する。
- O.[[RemainingKeys]] が空でない間、繰り返す、
- r を O.[[RemainingKeys]] の最初の要素とする。
- O.[[RemainingKeys]] から最初の要素を削除する。
- O.[[VisitedKeys]]
に r が含まれていない場合、
- desc を ? object.[[GetOwnProperty]](r) とする。
- desc が
undefined でない場合、- r を O.[[VisitedKeys]] に追加する。
- desc.[[Enumerable]] が
true の場合、CreateIteratorResultObject (r,false ) を返す。
- object を ? object.[[GetPrototypeOf]]() に設定する。
- O.[[Object]] を object に設定する。
- O.[[ObjectWasVisited]] を
false に設定する。 - object が
null の場合、CreateIteratorResultObject (undefined ,true ) を返す。
- O.[[ObjectWasVisited]] が
14.7.5.10.3 for-in イテレータインスタンスのプロパティ
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[Object]] | オブジェクト | プロパティを反復しているオブジェクト値。 |
| [[ObjectWasVisited]] | ブール値 |
|
| [[VisitedKeys]] |
|
この |
| [[RemainingKeys]] |
|
現在のオブジェクトのためにこれから返される値。プロトタイプ（プロトタイプが |
14.8 continue 文
構文
14.8.1 静的セマンティクス：早期エラー
-
この
ContinueStatement が、直接的または間接的（ただし関数またはstatic初期化ブロックの境界をまたがない）に、IterationStatement 内に入れ子になっていない場合、構文エラーとなる。
14.8.2 実行時意味論：評価
Completion Record { [[Type]]:continue , [[Value]]:empty , [[Target]]:empty } を返す。
- label を
LabelIdentifier のStringValue とする。 Completion Record { [[Type]]:continue , [[Value]]:empty , [[Target]]: label } を返す。
14.9 break 文
構文
14.9.1 静的セマンティクス：早期エラー
-
この
BreakStatement が、直接的または間接的（ただし関数またはstatic初期化ブロックの境界をまたがない）に、IterationStatement またはSwitchStatement 内に入れ子になっていない場合、構文エラーとなる。
14.9.2 実行時意味論：評価
Completion Record { [[Type]]:break , [[Value]]:empty , [[Target]]:empty } を返す。
- label を
LabelIdentifier のStringValue とする。 Completion Record { [[Type]]:break , [[Value]]:empty , [[Target]]: label } を返す。
14.10 return 文
構文
return 文は関数の実行を停止し、ほとんどの場合、呼び出し元に値を返す。return
文が実際に呼び出し元に値を返さない場合もあり得る。例えば、try ブロック内では、return 文の finally ブロックの評価中に別の
14.10.1 実行時意味論：評価
ReturnCompletion (undefined ) を返す。
- exprRef を ?
Evaluation （Expression ）とする。 - exprValue を ?
GetValue (exprRef) とする。 GetGeneratorKind () がasync の場合、exprValue を ?Await (exprValue) に設定する。ReturnCompletion (exprValue) を返す。
14.11 with 文
with 文の使用は新しい ECMAScript
コードでは推奨されません。
構文
with 文は、計算されたオブジェクトに対して
14.11.1 静的セマンティクス：早期エラー
-
IsStrict (この生成規則) がtrue の場合、構文エラーとなる。 -
IsLabelledFunction (Statement ) がtrue の場合、構文エラーとなる。
2つ目の規則は
14.11.2 実行時意味論：評価
- val を ?
Evaluation (Expression ) とする。 - obj を ?
ToObject (?GetValue (val)) とする。 - oldEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - newEnv を
NewObjectEnvironment (obj,true , oldEnv) とする。 実行中の実行コンテキスト の LexicalEnvironment を newEnv に設定する。- C を
Completion (Evaluation (Statement )) とする。 実行中の実行コンテキスト の LexicalEnvironment を oldEnv に設定する。- ?
UpdateEmpty (C,undefined ) を返す。
組み込みの
14.12 switch 文
構文
14.12.1 静的セマンティクス：早期エラー
-
CaseBlock のLexicallyDeclaredNames に重複するエントリが含まれている場合、構文エラーとなる。 -
CaseBlock のLexicallyDeclaredNames のいずれかの要素が、同じCaseBlock のVarDeclaredNames にも含まれている場合、構文エラーとなる。
14.12.2 実行時意味論：CaseBlockEvaluation
undefined を返す。
- V を
undefined とする。 - A を
CaseClauses 内のCaseClause 項目のソーステキスト順のリスト とする。 - found を
false とする。 - A の各
CaseClause C について、- found が
false の場合、- found を ?
CaseClauseIsSelected (C, input) に設定する。
- found を ?
- found が
true の場合、- R を
Completion (Evaluation (C)) とする。 - R.[[Value]] が
empty でない場合、V を R.[[Value]] に設定する。 - R が
abrupt completion の場合、?UpdateEmpty (R, V) を返す。
- R を
- found が
- V を返す。
- V を
undefined とする。 - 最初の
CaseClauses が存在する場合、- A を最初の
CaseClauses 内のCaseClause 項目のソーステキスト順リストとする。
- A を最初の
- それ以外の場合、
- A を新しい空の
リスト とする。
- A を新しい空の
- found を
false とする。 - A の各
CaseClause C について、- found が
false の場合、- found を ?
CaseClauseIsSelected (C, input) に設定する。
- found を ?
- found が
true の場合、- R を
Completion (Evaluation (C)) とする。 - R.[[Value]] が
empty でない場合、V を R.[[Value]] に設定する。 - R が
abrupt completion の場合、?UpdateEmpty (R, V) を返す。
- R を
- found が
- foundInB を
false とする。 - 2つ目の
CaseClauses が存在する場合、- B を2つ目の
CaseClauses 内のCaseClause 項目のソーステキスト順リストとする。
- B を2つ目の
- それ以外の場合、
- B を新しい空の
リスト とする。
- B を新しい空の
- found が
false の場合、- B の各
CaseClause C について、- foundInB が
false の場合、- foundInB を ?
CaseClauseIsSelected (C, input) に設定する。
- foundInB を ?
- foundInB が
true の場合、- R を
Completion (Evaluation (CaseClause C)) とする。 - R.[[Value]] が
empty でない場合、V を R.[[Value]] に設定する。 - R が
abrupt completion の場合、?UpdateEmpty (R, V) を返す。
- R を
- foundInB が
- B の各
- foundInB が
true の場合、V を返す。 - defaultR を
Completion (Evaluation (DefaultClause )) とする。 - defaultR.[[Value]] が
empty でない場合、V を defaultR.[[Value]] に設定する。 - defaultR が
abrupt completion の場合、?UpdateEmpty (defaultR, V) を返す。 - 注：以下は2つ目の
CaseClauses の完全な反復である。 - B の各
CaseClause C について、- R を
Completion (Evaluation (CaseClause C)) とする。 - R.[[Value]] が
empty でない場合、V を R.[[Value]] に設定する。 - R が
abrupt completion の場合、?UpdateEmpty (R, V) を返す。
- R を
- V を返す。
14.12.3 CaseClauseIsSelected ( C, input )
抽象操作 CaseClauseIsSelected は、引数 C（
アサート ： C は下記生成規則のインスタンスであること。CaseClause : case Expression : StatementList opt - exprRef を ?
Evaluation (C のExpression ) とする。 - clauseSelector を ?
GetValue (exprRef) とする。 IsStrictlyEqual (input, clauseSelector) を返す。
この操作は C の
14.12.4 実行時意味論：評価
- exprRef を ?
Evaluation (Expression ) とする。 - switchValue を ?
GetValue (exprRef) とする。 - oldEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - blockEnv を
NewDeclarativeEnvironment (oldEnv) とする。 BlockDeclarationInstantiation (CaseBlock , blockEnv) を実行する。実行中の実行コンテキスト の LexicalEnvironment を blockEnv に設定する。- R を
Completion (CaseBlockEvaluation (CaseBlock , switchValue)) とする。 実行中の実行コンテキスト の LexicalEnvironment を oldEnv に設定する。- R を返す。
どのような制御で
empty を返す。
- ?
Evaluation (StatementList ) を返す。
empty を返す。
- ?
Evaluation (StatementList ) を返す。
14.13 ラベル付き文
構文
break および continue
文と組み合わせてのみ使用される。ECMAScript には goto 文は存在しない。
14.13.1 静的セマンティクス：早期エラー
- この生成規則にマッチするソーステキストがある場合、構文エラーとなる。
この規則の代替定義は
14.13.2 静的セマンティクス：IsLabelledFunction ( stmt )
抽象操作 IsLabelledFunction は、引数 stmt（
- stmt が
LabelledStatement でない場合、false を返す。 - item を stmt の
LabelledItem とする。 - item が
LabelledItem : FunctionDeclaration true を返す。 - subStmt を item の
Statement とする。 IsLabelledFunction (subStmt) を返す。
14.13.3 実行時意味論：評価
- ?
LabelledEvaluation （このLabelledStatement ，引数 « »）を返す。
14.13.4 実行時意味論：LabelledEvaluation
- stmtResult を
Completion (LoopEvaluation (IterationStatement ，引数 labelSet)) とする。 - stmtResult が
break completion の場合、- stmtResult.[[Target]] が
empty の場合、- stmtResult.[[Value]] が
empty の場合、stmtResult をNormalCompletion (undefined ) に設定する。 - それ以外の場合、stmtResult を
NormalCompletion (stmtResult.[[Value]]) に設定する。
- stmtResult.[[Value]] が
- stmtResult.[[Target]] が
- ? stmtResult を返す。
- stmtResult を
Completion (Evaluation (SwitchStatement )) とする。 - stmtResult が
break completion の場合、- stmtResult.[[Target]] が
empty の場合、- stmtResult.[[Value]] が
empty の場合、stmtResult をNormalCompletion (undefined ) に設定する。 - それ以外の場合、stmtResult を
NormalCompletion (stmtResult.[[Value]]) に設定する。
- stmtResult.[[Value]] が
- stmtResult.[[Target]] が
- ? stmtResult を返す。
- label を
LabelIdentifier のStringValue とする。 - newLabelSet を labelSet と « label » の
リスト連結 とする。 - stmtResult を
Completion (LabelledEvaluation (LabelledItem ，引数 newLabelSet)) とする。 - stmtResult が
break completion かつ stmtResult.[[Target]] が label の場合、- stmtResult を
NormalCompletion (stmtResult.[[Value]]) に設定する。
- stmtResult を
- ? stmtResult を返す。
- ?
Evaluation (FunctionDeclaration ) を返す。
- ?
Evaluation (Statement ) を返す。
14.14 throw 文
構文
14.14.1 実行時意味論：評価
- exprRef を ?
Evaluation (Expression ) とする。 - exprValue を ?
GetValue (exprRef) とする。 ThrowCompletion (exprValue) を返す。
14.15 try 文
構文
try 文は、実行時エラーや throw 文などの例外的状況が発生しうるコードブロックを囲む。catch
節は例外処理コードを提供する。catch 節が例外を捕捉した時、その
14.15.1 静的セマンティクス：早期エラー
-
CatchParameter のBoundNames に重複する要素が含まれている場合、構文エラーとなる。 -
CatchParameter のBoundNames のいずれかの要素が、Block のLexicallyDeclaredNames にも含まれている場合、構文エラーとなる。 -
CatchParameter のBoundNames のいずれかの要素が、Block のVarDeclaredNames にも含まれている場合、構文エラーとなる。
14.15.2 実行時意味論：CatchClauseEvaluation
- oldEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - catchEnv を
NewDeclarativeEnvironment (oldEnv) とする。 CatchParameter のBoundNames の各要素 argName について、- ! catchEnv.CreateMutableBinding(argName,
false ) を実行する。
- ! catchEnv.CreateMutableBinding(argName,
実行中の実行コンテキスト の LexicalEnvironment を catchEnv に設定する。- status を
Completion (BindingInitialization (CatchParameter , 引数 thrownValue, catchEnv)) とする。 - status が
abrupt completion の場合、実行中の実行コンテキスト の LexicalEnvironment を oldEnv に設定する。- ? status を返す。
- B を
Completion (Evaluation (Block )) とする。 実行中の実行コンテキスト の LexicalEnvironment を oldEnv に設定する。- ? B を返す。
- ?
Evaluation (Block ) を返す。
どのような制御で
14.15.3 実行時意味論：評価
- B を
Completion (Evaluation (Block )) とする。 - B が
throw completion の場合、C をCompletion (CatchClauseEvaluation (Catch , B.[[Value]])) とする。 - それ以外の場合、C を B とする。
- ?
UpdateEmpty (C,undefined ) を返す。
- B を
Completion (Evaluation (Block )) とする。 - F を
Completion (Evaluation (Finally )) とする。 - F が
normal completion の場合、F を B に設定する。 - ?
UpdateEmpty (F,undefined ) を返す。
- B を
Completion (Evaluation (Block )) とする。 - B が
throw completion の場合、C をCompletion (CatchClauseEvaluation (Catch , B.[[Value]])) とする。 - それ以外の場合、C を B とする。
- F を
Completion (Evaluation (Finally )) とする。 - F が
normal completion の場合、F を C に設定する。 - ?
UpdateEmpty (F,undefined ) を返す。
14.16 debugger 文
構文
14.16.1 実行時意味論：評価
- 実装依存のデバッグ機能が利用可能かつ有効であれば、
- 実装依存のデバッグ動作を行う。
- 新しい実装依存の
Completion Record を返す。
- それ以外の場合、
empty を返す。
15 ECMAScript 言語：関数とクラス
15.1 パラメータリスト
構文
15.1.1 静的セマンティクス：早期エラー
-
FormalParameters のBoundNames に重複する要素が含まれている場合、構文エラーとなる。
-
FormalParameterList のIsSimpleParameterList がfalse かつBoundNames に重複する要素が含まれている場合、構文エラーとなる。
15.1.2 静的セマンティクス：ContainsExpression
false を返す。
false を返す。
- has を
ContainsExpression （BindingElementList ）とする。 - has が
true の場合、true を返す。 ContainsExpression （BindingRestElement ）を返す。
- has を
ContainsExpression （BindingPropertyList ）とする。 - has が
true の場合、true を返す。 ContainsExpression （BindingProperty ）を返す。
- has を
ContainsExpression （BindingElementList ）とする。 - has が
true の場合、true を返す。 ContainsExpression （BindingElisionElement ）を返す。
- has を
IsComputedPropertyKey （PropertyName ）とする。 - has が
true の場合、true を返す。 ContainsExpression （BindingElement ）を返す。
true を返す。
false を返す。
true を返す。
false を返す。
false を返す。
ContainsExpression （FormalParameterList ）がtrue の場合、true を返す。ContainsExpression （FunctionRestParameter ）を返す。
ContainsExpression （FormalParameterList ）がtrue の場合、true を返す。ContainsExpression （FormalParameter ）を返す。
false を返す。
- formals を
CoverParenthesizedExpressionAndArrowParameterList によってカバーされる ArrowFormalParameters とする。 ContainsExpression （formals）を返す。
false を返す。
15.1.3 静的セマンティクス：IsSimpleParameterList
false を返す。
false を返す。
true を返す。
false を返す。
true を返す。
false を返す。
false を返す。
IsSimpleParameterList （FormalParameterList ）がfalse の場合、false を返す。IsSimpleParameterList （FormalParameter ）を返す。
true を返す。
- formals を
CoverParenthesizedExpressionAndArrowParameterList によってカバーされる ArrowFormalParameters とする。 IsSimpleParameterList （formals）を返す。
true を返す。
- head を
CoverCallExpressionAndAsyncArrowHead によってカバーされる AsyncArrowHead とする。 IsSimpleParameterList （head）を返す。
15.1.4 静的セマンティクス：HasInitializer
false を返す。
true を返す。
false を返す。
true を返す。
HasInitializer （FormalParameterList ）がtrue の場合、true を返す。HasInitializer （FormalParameter ）を返す。
15.1.5 静的セマンティクス：ExpectedArgumentCount
- 0 を返す。
FormalParameter のHasInitializer がtrue の場合、0 を返す。- 1 を返す。
- count を
FormalParameterList のExpectedArgumentCount とする。 FormalParameterList のHasInitializer がtrue 、またはFormalParameter のHasInitializer がtrue の場合、count を返す。- count + 1 を返す。
- 1 を返す。
- formals を
CoverParenthesizedExpressionAndArrowParameterList によってカバーされる ArrowFormalParameters とする。 - formals の
ExpectedArgumentCount を返す。
FormalParameter のHasInitializer がtrue の場合、0 を返す。- 1 を返す。
- 1 を返す。
15.2 関数定義
構文
15.2.1 静的セマンティクス：早期エラー
-
IsStrict (FormalParameters ) がtrue の場合、UniqueFormalParameters : FormalParameters -
BindingIdentifier が存在し、IsStrict (BindingIdentifier ) がtrue の場合、BindingIdentifier のStringValue が"eval" または"arguments" の場合、構文エラーとなる。 -
FunctionBodyContainsUseStrict (FunctionBody ) がtrue かつIsSimpleParameterList (FormalParameters ) がfalse の場合、構文エラーとなる。 -
FormalParameters のBoundNames のいずれかの要素がFunctionBody のLexicallyDeclaredNames にも含まれている場合、構文エラーとなる。 -
FormalParameters Contains SuperProperty がtrue の場合、構文エラーとなる。 -
FunctionBody Contains SuperProperty がtrue の場合、構文エラーとなる。 -
FormalParameters Contains SuperCall がtrue の場合、構文エラーとなる。 -
FunctionBody Contains SuperCall がtrue の場合、構文エラーとなる。
-
FunctionStatementList のLexicallyDeclaredNames に重複するエントリが含まれている場合、構文エラーとなる。 -
FunctionStatementList のLexicallyDeclaredNames のいずれかの要素が同じFunctionStatementList のVarDeclaredNames にも含まれている場合、構文エラーとなる。 -
ContainsDuplicateLabels (FunctionStatementList , 引数 « ») がtrue の場合、構文エラーとなる。 -
ContainsUndefinedBreakTarget (FunctionStatementList , 引数 « ») がtrue の場合、構文エラーとなる。 -
ContainsUndefinedContinueTarget (FunctionStatementList , 引数 « » および « ») がtrue の場合、構文エラーとなる。
15.2.2 静的セマンティクス：FunctionBodyContainsUseStrict
FunctionBody のDirective Prologue にUse Strict Directive が含まれていればtrue を、そうでなければfalse を返す。
15.2.3 実行時意味論：EvaluateFunctionBody
- ?
FunctionDeclarationInstantiation (functionObject, argumentsList) を実行する。 - ?
Evaluation (FunctionStatementList ) を実行する。 - 注：前のステップが
normal completion となった場合、評価はFunctionStatementList の末尾を通過して終了する。 ReturnCompletion (undefined ) を返す。
15.2.4 実行時意味論：InstantiateOrdinaryFunctionObject
- name を
BindingIdentifier のStringValue とする。 - sourceText を
FunctionDeclaration にマッチしたソーステキスト とする。 - F を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (F, name) を実行する。MakeConstructor (F) を実行する。- F を返す。
- sourceText を
FunctionDeclaration にマッチしたソーステキスト とする。 - F を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (F,"default" ) を実行する。MakeConstructor (F) を実行する。- F を返す。
匿名の export default 宣言の一部としてのみ現れ、その関数コードは常に
15.2.5 実行時意味論：InstantiateOrdinaryFunctionExpression
- name が存在しない場合、name を
"" に設定する。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
FunctionExpression にマッチしたソーステキスト とする。 - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。MakeConstructor (closure) を実行する。- closure を返す。
アサート ：name は存在しない。- name を
BindingIdentifier のStringValue に設定する。 - outerEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - funcEnv を
NewDeclarativeEnvironment (outerEnv) とする。 - ! funcEnv.CreateImmutableBinding(name,
false ) を実行する。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
FunctionExpression にマッチしたソーステキスト とする。 - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , funcEnv, privateEnv) とする。 SetFunctionName (closure, name) を実行する。MakeConstructor (closure) を実行する。- ! funcEnv.InitializeBinding(name, closure) を実行する。
- closure を返す。
15.2.6 実行時意味論：評価
empty を返す。
代替意味論が
empty を返す。
undefined を返す。
15.3 アロー関数定義
構文
補足構文
次の生成規則のインスタンスを処理する際
15.3.1 静的セマンティクス：早期エラー
-
ArrowParameters Contains YieldExpression がtrue の場合、構文エラーとなる。 -
ArrowParameters Contains AwaitExpression がtrue の場合、構文エラーとなる。 -
ConciseBodyContainsUseStrict (ConciseBody ) がtrue かつIsSimpleParameterList (ArrowParameters ) がfalse の場合、構文エラーとなる。 -
ArrowParameters のBoundNames のいずれかの要素がConciseBody のLexicallyDeclaredNames にも含まれている場合、構文エラーとなる。
-
CoverParenthesizedExpressionAndArrowParameterList は必ず ArrowFormalParameters をカバーしなければならない。
15.3.2 静的セマンティクス：ConciseBodyContainsUseStrict
false を返す。
15.3.3 実行時意味論：EvaluateConciseBody
- ?
FunctionDeclarationInstantiation (functionObject, argumentsList) を実行する。 - ?
Evaluation (ExpressionBody ) を返す。
15.3.4 実行時意味論：InstantiateArrowFunctionExpression
- name が存在しない場合、name を
"" に設定する。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
ArrowFunction にマッチしたソーステキスト とする。 - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,ArrowParameters ,ConciseBody ,lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- closure を返す。
arguments、super、this、new.target
のローカル束縛を定義しない。arguments、super、this、new.target
への参照は、静的に囲まれた環境の束縛に解決されなければならない。通常は、直近の囲まれた関数の Function Environment となる。super への参照を含んでいても、手順 super
を参照する場合、それは必ず非super を実装するために必要な状態は
15.3.5 実行時意味論：評価
- exprRef を ?
Evaluation (AssignmentExpression ) とする。 - exprValue を ?
GetValue (exprRef) とする。 ReturnCompletion (exprValue) を返す。
15.4 メソッド定義
構文
15.4.1 静的セマンティクス：早期エラー
-
FunctionBody のFunctionBodyContainsUseStrict がtrue かつUniqueFormalParameters のIsSimpleParameterList がfalse の場合、構文エラーとなる。 -
UniqueFormalParameters のBoundNames のいずれかの要素がFunctionBody のLexicallyDeclaredNames にも含まれている場合、構文エラーとなる。
-
PropertySetParameterList のBoundNames に重複する要素が含まれている場合、構文エラーとなる。 -
FunctionBody のFunctionBodyContainsUseStrict がtrue かつPropertySetParameterList のIsSimpleParameterList がfalse の場合、構文エラーとなる。 -
PropertySetParameterList のBoundNames のいずれかの要素がFunctionBody のLexicallyDeclaredNames にも含まれている場合、構文エラーとなる。
15.4.2 静的セマンティクス：HasDirectSuper
UniqueFormalParameters Contains (SuperCall ) がtrue の場合、true を返す。FunctionBody Contains (SuperCall ) を返す。
FunctionBody Contains (SuperCall ) を返す。
PropertySetParameterList Contains (SuperCall ) がtrue の場合、true を返す。FunctionBody Contains (SuperCall ) を返す。
UniqueFormalParameters Contains (SuperCall ) がtrue の場合、true を返す。GeneratorBody Contains (SuperCall ) を返す。
UniqueFormalParameters Contains (SuperCall ) がtrue の場合、true を返す。AsyncGeneratorBody Contains (SuperCall ) を返す。
UniqueFormalParameters Contains (SuperCall ) がtrue の場合、true を返す。AsyncFunctionBody Contains (SuperCall ) を返す。
15.4.3 静的セマンティクス：SpecialMethod
false を返す。
true を返す。
15.4.4 実行時意味論：DefineMethod
- propKey を ?
Evaluation (ClassElementName ) とする。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - functionPrototype が存在する場合、
- prototype を functionPrototype に設定する。
- それ以外の場合、
- prototype を
%Function.prototype% に設定する。
- prototype を
- sourceText を
MethodDefinition にマッチしたソーステキスト とする。 - closure を
OrdinaryFunctionCreate (prototype, sourceText,UniqueFormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。Record { [[Key]]: propKey, [[Closure]]: closure } を返す。
15.4.5 実行時意味論：MethodDefinitionEvaluation
- methodDef を ?
DefineMethod (MethodDefinition , 引数 object) とする。 SetFunctionName (methodDef.[[Closure]], methodDef.[[Key]]) を実行する。- ?
DefineMethodProperty (object, methodDef.[[Key]], methodDef.[[Closure]], enumerable) を返す。
- propKey を ?
Evaluation (ClassElementName ) とする。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
MethodDefinition にマッチしたソーステキスト とする。 - formalParameterList を以下の生成規則のインスタンスとする：
FormalParameters : [空] - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameterList,FunctionBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。SetFunctionName (closure, propKey,"get" ) を実行する。- propKey が
Private Name であれば、PrivateElement { [[Key]]: propKey, [[Kind]]:accessor , [[Get]]: closure, [[Set]]:undefined } を返す。
- それ以外の場合、
- desc を PropertyDescriptor { [[Get]]:
closure, [[Enumerable]]:
enumerable, [[Configurable]]:
true } とする。 - ?
DefinePropertyOrThrow (object, propKey, desc) を実行する。 unused を返す。
- desc を PropertyDescriptor { [[Get]]:
closure, [[Enumerable]]:
enumerable, [[Configurable]]:
- propKey を ?
Evaluation (ClassElementName ) とする。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
MethodDefinition にマッチしたソーステキスト とする。 - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,PropertySetParameterList ,FunctionBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。SetFunctionName (closure, propKey,"set" ) を実行する。- propKey が
Private Name であれば、PrivateElement { [[Key]]: propKey, [[Kind]]:accessor , [[Get]]:undefined , [[Set]]: closure } を返す。
- それ以外の場合、
- desc を PropertyDescriptor { [[Set]]:
closure, [[Enumerable]]:
enumerable, [[Configurable]]:
true } とする。 - ?
DefinePropertyOrThrow (object, propKey, desc) を実行する。 unused を返す。
- desc を PropertyDescriptor { [[Set]]:
closure, [[Enumerable]]:
enumerable, [[Configurable]]:
- propKey を ?
Evaluation (ClassElementName ) とする。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
GeneratorMethod にマッチしたソーステキスト とする。 - closure を
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。SetFunctionName (closure, propKey) を実行する。- prototype を
OrdinaryObjectCreate (%GeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - ?
DefineMethodProperty (object, propKey, closure, enumerable) を返す。
- propKey を ?
Evaluation (ClassElementName ) とする。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
AsyncGeneratorMethod にマッチしたソーステキスト とする。 - closure を
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。SetFunctionName (closure, propKey) を実行する。- prototype を
OrdinaryObjectCreate (%AsyncGeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - ?
DefineMethodProperty (object, propKey, closure, enumerable) を返す。
- propKey を ?
Evaluation (ClassElementName ) とする。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
AsyncMethod にマッチしたソーステキスト とする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。SetFunctionName (closure, propKey) を実行する。- ?
DefineMethodProperty (object, propKey, closure, enumerable) を返す。
15.5 ジェネレーター関数定義
構文
yield の直後の構文的文脈は
15.5.1 静的セマンティクス：早期エラー
-
GeneratorMethod のHasDirectSuper がtrue の場合、構文エラーとなる。 -
UniqueFormalParameters Contains (YieldExpression ) がtrue の場合、構文エラーとなる。 -
GeneratorBody のFunctionBodyContainsUseStrict がtrue かつUniqueFormalParameters のIsSimpleParameterList がfalse の場合、構文エラーとなる。 -
UniqueFormalParameters のBoundNames のいずれかの要素がGeneratorBody のLexicallyDeclaredNames にも含まれている場合、構文エラーとなる。
-
IsStrict (FormalParameters ) がtrue の場合、UniqueFormalParameters : FormalParameters -
BindingIdentifier が存在し、IsStrict (BindingIdentifier ) がtrue の場合、BindingIdentifier のStringValue が"eval" または"arguments" の場合、構文エラーとなる。 -
FunctionBodyContainsUseStrict (GeneratorBody ) がtrue かつIsSimpleParameterList (FormalParameters ) がfalse の場合、構文エラーとなる。 -
FormalParameters のBoundNames のいずれかの要素がGeneratorBody のLexicallyDeclaredNames にも含まれている場合、構文エラーとなる。 -
FormalParameters Contains (YieldExpression ) がtrue の場合、構文エラーとなる。 -
FormalParameters Contains (SuperProperty ) がtrue の場合、構文エラーとなる。 -
GeneratorBody Contains (SuperProperty ) がtrue の場合、構文エラーとなる。 -
FormalParameters Contains (SuperCall ) がtrue の場合、構文エラーとなる。 -
GeneratorBody Contains (SuperCall ) がtrue の場合、構文エラーとなる。
15.5.2 実行時意味論：EvaluateGeneratorBody
- ?
FunctionDeclarationInstantiation (functionObject, argumentsList) を実行する。 - G を ?
OrdinaryCreateFromConstructor (functionObject,"%GeneratorPrototype%" , « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] ») とする。 - G.[[GeneratorBrand]] を
empty に設定する。 - G.[[GeneratorState]] を
suspended-start に設定する。 GeneratorStart (G,FunctionBody ) を実行する。ReturnCompletion (G) を返す。
15.5.3 実行時意味論：InstantiateGeneratorFunctionObject
- name を
BindingIdentifier のStringValue に設定する。 - sourceText を
GeneratorDeclaration にマッチしたソーステキスト に設定する。 - F を
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv) に設定する。 SetFunctionName (F, name) を実行する。- prototype を
OrdinaryObjectCreate (%GeneratorPrototype% ) に設定する。 - !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - F を返す。
- sourceText を
GeneratorDeclaration にマッチしたソーステキスト に設定する。 - F を
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv) に設定する。 SetFunctionName (F,"default" ) を実行する。- prototype を
OrdinaryObjectCreate (%GeneratorPrototype% ) に設定する。 - !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - F を返す。
匿名の export default 宣言の一部としてのみ現れ、その関数コードは常に
15.5.4 実行時意味論：InstantiateGeneratorFunctionExpression
- name が存在しない場合、name を
"" に設定する。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
GeneratorExpression にマッチしたソーステキスト に設定する。 - closure を
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv) に設定する。 SetFunctionName (closure, name) を実行する。- prototype を
OrdinaryObjectCreate (%GeneratorPrototype% ) に設定する。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - closure を返す。
アサート ： name は存在しない。- name を
BindingIdentifier のStringValue に設定する。 - outerEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - funcEnv を
NewDeclarativeEnvironment (outerEnv) に設定する。 - ! funcEnv.CreateImmutableBinding(name,
false ) を実行する。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
GeneratorExpression にマッチしたソーステキスト に設定する。 - closure を
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , funcEnv, privateEnv) に設定する。 SetFunctionName (closure, name) を実行する。- prototype を
OrdinaryObjectCreate (%GeneratorPrototype% ) に設定する。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - ! funcEnv.InitializeBinding(name, closure) を実行する。
- closure を返す。
15.5.5 実行時意味論：評価
- ?
Yield (undefined ) を返す。
- exprRef を ?
Evaluation (AssignmentExpression ) とする。 - value を ?
GetValue (exprRef) とする。 - ?
Yield (value) を返す。
- generatorKind を
GetGeneratorKind () とする。 アサート ：generatorKind はsync またはasync のいずれかである。- exprRef を ?
Evaluation (AssignmentExpression ) とする。 - value を ?
GetValue (exprRef) とする。 - iteratorRecord を ?
GetIterator (value, generatorKind) とする。 - iterator を iteratorRecord.[[Iterator]] とする。
- received を
NormalCompletion (undefined ) とする。 - 繰り返す、
- received が
normal completion なら、- innerResult を ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « received.[[Value]] ») とする。 - generatorKind が
async なら、innerResult を ?Await (innerResult) に設定する。 - innerResult
がオブジェクトでない場合 、TypeError 例外をスローする。 - done を ?
IteratorComplete (innerResult) とする。 - done が
true なら、- ?
IteratorValue (innerResult) を返す。
- ?
- generatorKind が
async なら、received をCompletion (AsyncGeneratorYield (?IteratorValue (innerResult))) に設定する。 - それ以外の場合、received を
Completion (GeneratorYield (innerResult)) に設定する。
- innerResult を ?
- それ以外で received が
throw completion なら、- throw を ?
GetMethod (iterator,"throw" ) とする。 - throw が
undefined でない場合、- innerResult を ?
Call (throw, iterator, « received.[[Value]] ») とする。 - generatorKind が
async なら、innerResult を ?Await (innerResult) に設定する。 - 注：内部
イテレータ のthrowメソッドからの例外は伝播する。内部throwメソッドからのNormal completions は内部nextと同様に処理される。 - innerResult
がオブジェクトでない場合 、TypeError 例外をスローする。 - done を ?
IteratorComplete (innerResult) とする。 - done が
true なら、- ?
IteratorValue (innerResult) を返す。
- ?
- generatorKind が
async なら、received をCompletion (AsyncGeneratorYield (?IteratorValue (innerResult))) に設定する。 - それ以外の場合、received を
Completion (GeneratorYield (innerResult)) に設定する。
- innerResult を ?
- それ以外の場合、
- 注：iterator に
throwメソッドがない場合、この throw でyield*ループが終了する。ただしまず iterator にクリーンアップの機会を与える必要がある。 - closeCompletion を
NormalCompletion (empty ) に設定する。 - generatorKind が
async なら、?AsyncIteratorClose (iteratorRecord, closeCompletion) を実行する。 - それ以外の場合、?
IteratorClose (iteratorRecord, closeCompletion) を実行する。 - 注：次のステップは
TypeError をスローし、yield*プロトコル違反を示す：iterator にthrowメソッドがない。 TypeError 例外をスローする。
- 注：iterator に
- throw を ?
- それ以外の場合、
アサート ：received はreturn completion である。- return を ?
GetMethod (iterator,"return" ) とする。 - return が
undefined の場合、- value を received.[[Value]] に設定する。
- generatorKind が
async の場合、- value を ?
Await (value) に設定する。
- value を ?
ReturnCompletion (value) を返す。
- innerReturnResult を ?
Call (return, iterator, « received.[[Value]] ») に設定する。 - generatorKind が
async の場合、innerReturnResult を ?Await (innerReturnResult) に設定する。 - innerReturnResult
がオブジェクトでない場合 、TypeError 例外をスローする。 - done を ?
IteratorComplete (innerReturnResult) に設定する。 - done が
true の場合、- value を ?
IteratorValue (innerReturnResult) に設定する。 ReturnCompletion (value) を返す。
- value を ?
- generatorKind が
async の場合、received をCompletion (AsyncGeneratorYield (?IteratorValue (innerReturnResult))) に設定する。 - それ以外の場合、received を
Completion (GeneratorYield (innerReturnResult)) に設定する。
- received が
15.6 非同期ジェネレーター関数定義
構文
15.6.1 静的セマンティクス：早期エラー
HasDirectSuper がAsyncGeneratorMethod に対してtrue の場合、構文エラーとなります。UniqueFormalParameters Contains YieldExpression がtrue の場合、構文エラーとなります。UniqueFormalParameters Contains AwaitExpression がtrue の場合、構文エラーとなります。FunctionBodyContainsUseStrict がAsyncGeneratorBody に対してtrue かつIsSimpleParameterList がUniqueFormalParameters に対してfalse の場合、構文エラーとなります。BoundNames の要素のいずれかが、UniqueFormalParameters のものと、LexicallyDeclaredNames のAsyncGeneratorBody のものと重複する場合、構文エラーとなります。
IsStrict (FormalParameters ) がtrue の場合、UniqueFormalParameters : FormalParameters BindingIdentifier が存在し、IsStrict (BindingIdentifier ) がtrue の場合、BindingIdentifier のStringValue が"eval" または"arguments" であるとき、構文エラーとなります。FunctionBodyContainsUseStrict がAsyncGeneratorBody に対してtrue かつIsSimpleParameterList がFormalParameters に対してfalse の場合、構文エラーとなります。BoundNames の要素のいずれかが、FormalParameters のものと、LexicallyDeclaredNames のAsyncGeneratorBody のものと重複する場合、構文エラーとなります。FormalParameters Contains YieldExpression がtrue の場合、構文エラーとなります。FormalParameters Contains AwaitExpression がtrue の場合、構文エラーとなります。FormalParameters Contains SuperProperty がtrue の場合、構文エラーとなります。AsyncGeneratorBody Contains SuperProperty がtrue の場合、構文エラーとなります。FormalParameters Contains SuperCall がtrue の場合、構文エラーとなります。AsyncGeneratorBody Contains SuperCall がtrue の場合、構文エラーとなります。
15.6.2 実行時意味論: EvaluateAsyncGeneratorBody
- ?
FunctionDeclarationInstantiation (functionObject, argumentsList) を実行する。 - generator を ?
OrdinaryCreateFromConstructor (functionObject,"%AsyncGeneratorPrototype%" , « [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] ») とする。 - generator.[[GeneratorBrand]] に
empty を設定する。 - generator.[[AsyncGeneratorState]] に
suspended-start を設定する。 AsyncGeneratorStart (generator,FunctionBody ) を実行する。ReturnCompletion (generator) を返す。
15.6.3 実行時意味論: InstantiateAsyncGeneratorFunctionObject
- name を、
StringValue （BindingIdentifier の）とする。 - sourceText を
一致したソーステキスト （AsyncGeneratorDeclaration の）とする。 - F を
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (F, name) を実行する。- prototype を
OrdinaryObjectCreate (%AsyncGeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - F を返す。
- sourceText を
一致したソーステキスト （AsyncGeneratorDeclaration の）とする。 - F を
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (F,"default" ) を実行する。- prototype を
OrdinaryObjectCreate (%AsyncGeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - F を返す。
匿名の export default 宣言の一部としてのみ出現可能です。
15.6.4 実行時意味論: InstantiateAsyncGeneratorFunctionExpression
- name が存在しない場合、name に
"" を設定する。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
一致したソーステキスト （AsyncGeneratorExpression の）とする。 - closure を
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- prototype を
OrdinaryObjectCreate (%AsyncGeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - closure を返す。
Assert : name は存在しない。- name を
StringValue （BindingIdentifier の）とする。 - outerEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - funcEnv を
NewDeclarativeEnvironment (outerEnv) とする。 - ! funcEnv.CreateImmutableBinding(name,
false ) を実行する。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
一致したソーステキスト （AsyncGeneratorExpression の）とする。 - closure を
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , funcEnv, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- prototype を
OrdinaryObjectCreate (%AsyncGeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - ! funcEnv.InitializeBinding(name, closure) を実行する。
- closure を返す。
15.6.5 実行時意味論: 評価
15.7 クラス定義
構文
クラス定義は常に
15.7.1 静的セマンティクス：早期エラー
-
ClassHeritage が存在しない場合、次のアルゴリズムがtrue を返すとき、構文エラーとなります：- constructor を
ConstructorMethod （ClassBody の）とする。 - constructor が
empty の場合、false を返す。 - constructor の
HasDirectSuper を返す。
- constructor を
-
ClassElementList のPrototypePropertyNameList に"constructor" が2回以上出現する場合、構文エラーとなります。 -
ClassElementList のPrivateBoundIdentifiers に重複する要素が含まれる場合、ただし同じ名前がゲッターとセッターとして1回ずつだけ使われ、他の用途に使われておらず、かつ両者がともに static またはともに static でない場合は除き、構文エラーとなります。
-
MethodDefinition のPropName が"constructor" でなく、HasDirectSuper がtrue の場合、構文エラーとなります。 -
MethodDefinition のPropName が"constructor" で、SpecialMethod がtrue の場合、構文エラーとなります。
-
MethodDefinition のHasDirectSuper がtrue の場合、構文エラーとなります。 -
MethodDefinition のPropName が"prototype" の場合、構文エラーとなります。
-
FieldDefinition のPropName が"constructor" の場合、構文エラーとなります。
-
FieldDefinition のPropName が"prototype" または"constructor" の場合、構文エラーとなります。
-
Initializer が存在し、ContainsArguments がtrue の場合、構文エラーとなります。 -
Initializer が存在し、Initializer のContains SuperCall がtrue の場合、構文エラーとなります。
-
PrivateIdentifier のStringValue が"#constructor" の場合、構文エラーとなります。
-
ClassStaticBlockStatementList のLexicallyDeclaredNames に重複する要素が含まれる場合、構文エラーとなります。 -
ClassStaticBlockStatementList のLexicallyDeclaredNames の要素が、VarDeclaredNames （ClassStaticBlockStatementList の）にも含まれる場合、構文エラーとなります。 -
ClassStaticBlockStatementList のContainsDuplicateLabels （引数 « »）がtrue の場合、構文エラーとなります。 -
ClassStaticBlockStatementList のContainsUndefinedBreakTarget （引数 « »）がtrue の場合、構文エラーとなります。 -
ClassStaticBlockStatementList のContainsUndefinedContinueTarget （引数 « » および « »）がtrue の場合、構文エラーとなります。 -
ClassStaticBlockStatementList のContainsArguments がtrue の場合、構文エラーとなります。 -
ClassStaticBlockStatementList のContains SuperCall がtrue の場合、構文エラーとなります。 -
ClassStaticBlockStatementList のContains awaitがtrue の場合、構文エラーとなります。
15.7.2 静的セマンティクス: ClassElementKind
MethodDefinition のPropName が"constructor" の場合、constructor-method を返す。non-constructor-method を返す。
non-constructor-method を返す。
non-constructor-method を返す。
empty を返す。
15.7.3 静的セマンティクス: ConstructorMethod
ClassElement のClassElementKind がconstructor-method の場合、ClassElement を返す。empty を返す。
- head を
ConstructorMethod （ClassElementList の）とする。 - head が
empty でない場合、head を返す。 ClassElement のClassElementKind がconstructor-method の場合、ClassElement を返す。empty を返す。
早期エラー規則により、
15.7.4 静的セマンティクス: IsStatic
false を返す。
true を返す。
false を返す。
true を返す。
true を返す。
false を返す。
15.7.5 静的セマンティクス: NonConstructorElements
ClassElement のClassElementKind がnon-constructor-method の場合、- «
ClassElement » を返す。
- «
- 新しい空の
List を返す。
- list を
NonConstructorElements （ClassElementList の）とする。 ClassElement のClassElementKind がnon-constructor-method の場合、ClassElement を list の末尾に追加する。
- list を返す。
15.7.6 静的セマンティクス: PrototypePropertyNameList
- propName を
ClassElement のPropName とする。 - propName が
empty である場合、新しい空のList を返す。 ClassElement のIsStatic がtrue の場合、 新しい空のList を返す。- « propName » を返す。
- list を
PrototypePropertyNameList （ClassElementList の）とする。 - propName を
ClassElement のPropName とする。 - propName が
empty の場合、list を返す。 ClassElement のIsStatic がtrue の場合、 list を返す。- list と « propName » の
リスト結合 を返す。
15.7.7 静的セマンティクス: AllPrivateIdentifiersValid
この仕様の以下に示されていないすべての文法生成規則の選択肢は、AllPrivateIdentifiersValid のデフォルト定義を暗黙的に持ちます:
- この
構文ノード の各子ノード child について、- child が非終端記号のインスタンスである場合、
AllPrivateIdentifiersValid （child と引数 names）がfalse なら、false を返す。
- child が非終端記号のインスタンスである場合、
true を返す。
- names に
PrivateIdentifier のStringValue が含まれる場合、AllPrivateIdentifiersValid （MemberExpression と引数 names）を返す。
false を返す。
- names に
PrivateIdentifier のStringValue が含まれる場合、AllPrivateIdentifiersValid （CallExpression と引数 names）を返す。
false を返す。
- names に
PrivateIdentifier のStringValue が含まれる場合、true を返す。 false を返す。
- names に
PrivateIdentifier のStringValue が含まれる場合、AllPrivateIdentifiersValid （OptionalChain と引数 names）を返す。
false を返す。
- newNames を names と
PrivateBoundIdentifiers （ClassBody の）とのリスト結合 とする。 AllPrivateIdentifiersValid （ClassElementList と引数 newNames）を返す。
- names に
PrivateIdentifier のStringValue が含まれる場合、AllPrivateIdentifiersValid （ShiftExpression と引数 names）を返す。
false を返す。
15.7.8 静的セマンティクス: PrivateBoundIdentifiers
- 唯一の要素が
PrivateIdentifier のStringValue であるList を返す。
- 新しい空の
List を返す。
- names1 を
PrivateBoundIdentifiers （ClassElementList の）とする。 - names2 を
PrivateBoundIdentifiers （ClassElement の）とする。 - names1 と names2 の
リスト結合 を返す。
15.7.9 静的セマンティクス: ContainsArguments
この仕様の以下に示されていないすべての文法生成規則の選択肢は、ContainsArguments のデフォルト定義を暗黙的に持ちます:
- この
構文ノード の各子ノード child について、- child が非終端記号のインスタンスである場合、
ContainsArguments (child) がtrue なら、true を返す。
- child が非終端記号のインスタンスである場合、
false を返す。
Identifier のStringValue が"arguments" なら、true を返す。false を返す。
false を返す。
ContainsArguments （ClassElementName の）を返す。
15.7.10 実行時意味論: ClassFieldDefinitionEvaluation
- name を ?
Evaluation （ClassElementName の）とする。 Initializer が存在する場合、- formalParameterList を
FormalParameters : [empty] - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を空の Unicode コードポイント列とする。
- initializer を
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameterList,Initializer ,non-lexical-this , env, privateEnv) とする。 MakeMethod (initializer, homeObject) を実行する。- initializer.[[ClassFieldInitializerName]] に name を設定する。
- formalParameterList を
- それ以外の場合、
- initializer を
empty とする。
- initializer を
ClassFieldDefinition Record { [[Name]]: name, [[Initializer]]: initializer } を返す。
15.7.11 実行時意味論: ClassStaticBlockDefinitionEvaluation
- lex を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を空の Unicode コードポイント列とする。
- formalParameters を
FormalParameters : [empty] - bodyFunction を
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameters,ClassStaticBlockBody ,non-lexical-this , lex, privateEnv) とする。 MakeMethod (bodyFunction, homeObject) を実行する。ClassStaticBlockDefinition Record { [[BodyFunction]]: bodyFunction } を返す。
15.7.12 実行時意味論: EvaluateClassStaticBlockBody
Assert : functionObject はClassStaticBlockDefinitionEvaluation の5 で作成された合成関数である。- !
FunctionDeclarationInstantiation (functionObject, « ») を実行する。 - ?
Evaluation （ClassStaticBlockStatementList の）を実行する。 ReturnCompletion (undefined ) を返す。
15.7.13 実行時意味論: ClassElementEvaluation
- ?
ClassFieldDefinitionEvaluation （FieldDefinition の、引数 object）を返す。
- ?
MethodDefinitionEvaluation （MethodDefinition の、引数 object とfalse ）を返す。
ClassStaticBlockDefinitionEvaluation （ClassStaticBlock の、引数 object）を返す。
unused を返す。
15.7.14 実行時意味論: ClassDefinitionEvaluation
仕様上の都合のため、プライベートメソッドとアクセサは、クラスインスタンスの [[PrivateElements]] スロットにプライベートフィールドと一緒に含まれます。ただし、任意のオブジェクトは、あるクラスで定義されたすべてまたは全くプライベートメソッド・アクセサを持つことになります。この機能は、実装が各メソッドやアクセサを個別に追跡する必要のない戦略を選択できるよう設計されています。
例えば、実装はインスタンスプライベートメソッドを対応する this
値として実行したかを追跡することができます。オブジェクト上でインスタンスプライベートメソッドを検索するには、そのメソッドを定義するクラス
これはプライベートフィールドとは異なります。なぜなら、フィールドイニシャライザーがクラスのインスタンス化中に例外を投げる可能性があるため、個々のオブジェクトはあるクラスのプライベートフィールドの部分集合しか持たない場合があり、したがってプライベートフィールドは一般に個別に追跡する必要があります。
以下の生成規則ごとに部分的に定義されます:
- env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - classEnv を
NewDeclarativeEnvironment (env) とする。 - classBinding が
undefined でない場合、- ! classEnv.CreateImmutableBinding(classBinding,
true ) を実行する。
- ! classEnv.CreateImmutableBinding(classBinding,
- outerPrivateEnvironment を
実行中の実行コンテキスト の PrivateEnvironment とする。 - classPrivateEnvironment を
NewPrivateEnvironment (outerPrivateEnvironment) とする。 ClassBody が存在する場合、ClassBody のPrivateBoundIdentifiers の各文字列 dn について、- classPrivateEnvironment.[[Names]] に、
dn を [[Description]] に持つ
Private Name pn が含まれている場合、Assert : これはゲッター／セッターのペアの場合のみ発生する。
- それ以外の場合、
- name を dn を [[Description]] に持つ新しい
Private Name とする。 - name を classPrivateEnvironment.[[Names]] に追加する。
- name を dn を [[Description]] に持つ新しい
- classPrivateEnvironment.[[Names]] に、
dn を [[Description]] に持つ
ClassHeritage が存在しない場合、- protoParent を
%Object.prototype% とする。 - constructorParent を
%Function.prototype% とする。
- protoParent を
- それ以外の場合、
実行中の実行コンテキスト の LexicalEnvironment を classEnv に設定する。- 注:
実行中の実行コンテキスト の PrivateEnvironment はClassHeritage の評価時は outerPrivateEnvironment となる。 - superclassRef を
Completion (Evaluation （ClassHeritage ）) とする。 実行中の実行コンテキスト の LexicalEnvironment を env に設定する。- superclass を ?
GetValue (? superclassRef) とする。 - superclass が
null の場合、- protoParent を
null とする。 - constructorParent を
%Function.prototype% とする。
- protoParent を
- それ以外で
IsConstructor (superclass) がfalse の場合、TypeError 例外を投げる。
- それ以外の場合、
- proto を
OrdinaryObjectCreate (protoParent) とする。 ClassBody が存在しない場合、constructor をempty とする。- それ以外の場合、constructor を
ConstructorMethod （ClassBody の）とする。 実行中の実行コンテキスト の LexicalEnvironment を classEnv に設定する。実行中の実行コンテキスト の PrivateEnvironment を classPrivateEnvironment に設定する。- constructor が
empty の場合、- defaultConstructor を、パラメータなしで何もキャプチャせず、呼び出されたとき次の手順を実行する新しい
Abstract Closure とする:- args を、この関数に [[Call]] または [[Construct]] で渡された引数の
List とする。 - NewTarget が
undefined の場合、TypeError 例外を投げる。 - F を
アクティブな関数オブジェクト とする。 - F.[[ConstructorKind]] が
derived の場合、- 注: この分岐は
constructor(...args) { super(...args); }と同様に振る舞う。ただし、上記ECMAScript ソーステキスト は%Array.prototype%上の%Symbol.iterator% メソッドを呼び出すが、この関数は呼び出さないという顕著な違いがある。 - func を ! F.[[GetPrototypeOf]]() とする。
IsConstructor (func) がfalse の場合、TypeError 例外を投げる。- result を ?
Construct (func, args, NewTarget) とする。
- 注: この分岐は
- それ以外の場合、
- 注: この分岐は
constructor() {}と同様に振る舞う。 - result を ?
OrdinaryCreateFromConstructor (NewTarget,"%Object.prototype%" ) とする。
- 注: この分岐は
- ?
InitializeInstanceElements (result, F) を実行する。 NormalCompletion (result) を返す。
- args を、この関数に [[Call]] または [[Construct]] で渡された引数の
- F を
CreateBuiltinFunction (defaultConstructor, 0, className, « [[ConstructorKind]], [[SourceText]] »,現在の Realm Record , constructorParent) とする。
- defaultConstructor を、パラメータなしで何もキャプチャせず、呼び出されたとき次の手順を実行する新しい
- それ以外の場合、
- constructorInfo を !
DefineMethod （constructor、引数 proto と constructorParent）とする。 - F を constructorInfo.[[Closure]] とする。
MakeClassConstructor (F) を実行する。SetFunctionName (F, className) を実行する。
- constructorInfo を !
MakeConstructor (F,false , proto) を実行する。ClassHeritage が存在する場合、F.[[ConstructorKind]] をderived に設定する。DefineMethodProperty (proto,"constructor" , F,false ) を実行する。ClassBody が存在しない場合、elements を新しい空のList とする。- それ以外の場合、elements を
NonConstructorElements （ClassBody の）とする。 - instancePrivateMethods を新しい空の
List とする。 - staticPrivateMethods を新しい空の
List とする。 - instanceFields を新しい空の
List とする。 - staticElements を新しい空の
List とする。 - elements の各
ClassElement e について、IsStatic (e) がfalse の場合、- element を
Completion (ClassElementEvaluation (e, proto)) とする。
- element を
- それ以外の場合、
- element を
Completion (ClassElementEvaluation (e, F)) とする。
- element を
- element が
異常完了 の場合、実行中の実行コンテキスト の LexicalEnvironment を env に設定する。実行中の実行コンテキスト の PrivateEnvironment を outerPrivateEnvironment に設定する。- ? element を返す。
- element を ! element とする。
- element が
PrivateElement の場合、Assert : element.[[Kind]] はmethod またはaccessor 。IsStatic (e) がfalse なら container を instancePrivateMethods、それ以外は staticPrivateMethods とする。- container に element.[[Key]] と同じキーを持つ
PrivateElement pe が含まれている場合、Assert : element.[[Kind]] と pe.[[Kind]] は両方accessor 。- element.[[Get]] が
undefined の場合、- combined を
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: pe.[[Get]], [[Set]]: element.[[Set]] } とする。
- combined を
- それ以外の場合、
- combined を
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: element.[[Get]], [[Set]]: pe.[[Set]] } とする。
- combined を
- container 内の pe を combined で置換する。
- それ以外の場合、
- element を container に追加する。
- それ以外で element が
ClassFieldDefinition Record の場合、IsStatic (e) がfalse なら instanceFields に、そうでなければ staticElements に element を追加する。
- それ以外で element が
ClassStaticBlockDefinition Record の場合、- element を staticElements に追加する。
実行中の実行コンテキスト の LexicalEnvironment を env に設定する。- classBinding が
undefined でない場合、- ! classEnv.InitializeBinding(classBinding, F) を実行する。
- F.[[PrivateMethods]] を instancePrivateMethods に設定する。
- F.[[Fields]] を instanceFields に設定する。
- staticPrivateMethods の各
PrivateElement method について、- !
PrivateMethodOrAccessorAdd (F, method) を実行する。
- !
- staticElements の各 elementRecord について、
- elementRecord が
ClassFieldDefinition Record の場合、- result を
Completion (DefineField (F, elementRecord)) とする。
- result を
- それ以外の場合、
Assert : elementRecord はClassStaticBlockDefinition Record である。- result を
Completion (Call (elementRecord.[[BodyFunction]], F)) とする。
- result が
異常完了 の場合、実行中の実行コンテキスト の PrivateEnvironment を outerPrivateEnvironment に設定する。- ? result を返す。
- elementRecord が
実行中の実行コンテキスト の PrivateEnvironment を outerPrivateEnvironment に設定する。- F を返す。
15.7.15 実行時意味論: BindingClassDeclarationEvaluation
- className を
BindingIdentifier のStringValue とする。 - value を ?
ClassDefinitionEvaluation （ClassTail 、引数 className と className）とする。 - value.[[SourceText]] を
一致したソーステキスト （ClassDeclaration ）に設定する。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - ?
InitializeBoundName (className, value, env) を実行する。 - value を返す。
- value を ?
ClassDefinitionEvaluation （ClassTail 、引数undefined と"default" ）とする。 - value.[[SourceText]] を
一致したソーステキスト （ClassDeclaration ）に設定する。 - value を返す。
15.7.16 実行時意味論: 評価
- ?
BindingClassDeclarationEvaluation （このClassDeclaration ）を実行する。 empty を返す。
- value を ?
ClassDefinitionEvaluation （ClassTail 、引数undefined と"" ）とする。 - value.[[SourceText]] を
一致したソーステキスト （ClassExpression ）に設定する。 - value を返す。
- className を
BindingIdentifier のStringValue とする。 - value を ?
ClassDefinitionEvaluation （ClassTail 、引数 className と className）とする。 - value.[[SourceText]] を
一致したソーステキスト （ClassExpression ）に設定する。 - value を返す。
- privateIdentifier を
PrivateIdentifier のStringValue とする。 - privateEnvRec を
実行中の実行コンテキスト の PrivateEnvironment とする。 - names を privateEnvRec.[[Names]] とする。
Assert : names のちょうど1つの要素が [[Description]] が privateIdentifier であるPrivate Name である。- privateName を names 内の [[Description]] が
privateIdentifier である
Private Name とする。 - privateName を返す。
undefined を返す。
15.8 非同期関数定義
構文
await は [Await] パラメータが存在する場合、
AsyncFunctionBody 内。FormalParameters がAsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression のいずれかの場合。 この位置でのAwaitExpression は静的セマンティクス により構文エラーとなります。Module 内。
await は
[Await] パラメータが存在しない時、識別子として構文解析されることがあります。これには以下の文脈が含まれます：
15.8.1 静的セマンティクス: 早期エラー
-
AsyncFunctionBody のFunctionBodyContainsUseStrict がtrue かつUniqueFormalParameters のIsSimpleParameterList がfalse の場合、構文エラーとなります。 -
AsyncMethod のHasDirectSuper がtrue の場合、構文エラーとなります。 -
UniqueFormalParameters のContains AwaitExpression がtrue の場合、構文エラーとなります。 -
UniqueFormalParameters のBoundNames の任意の要素がAsyncFunctionBody のLexicallyDeclaredNames にも含まれている場合、構文エラーとなります。
-
AsyncFunctionBody のFunctionBodyContainsUseStrict がtrue かつFormalParameters のIsSimpleParameterList がfalse の場合、構文エラーとなります。 -
FormalParameters のContains AwaitExpression がtrue の場合、構文エラーとなります。 -
FormalParameters のIsStrict がtrue の場合、UniqueFormalParameters : FormalParameters -
BindingIdentifier が存在し、IsStrict (BindingIdentifier ) がtrue の場合、BindingIdentifier のStringValue が"eval" または"arguments" の場合、構文エラーとなります。 -
FormalParameters のBoundNames の任意の要素がAsyncFunctionBody のLexicallyDeclaredNames にも含まれている場合、構文エラーとなります。 -
FormalParameters のContains SuperProperty がtrue の場合、構文エラーとなります。 -
AsyncFunctionBody のContains SuperProperty がtrue の場合、構文エラーとなります。 -
FormalParameters のContains SuperCall がtrue の場合、構文エラーとなります。 -
AsyncFunctionBody のContains SuperCall がtrue の場合、構文エラーとなります。
15.8.2 実行時意味論: InstantiateAsyncFunctionObject
- name を
BindingIdentifier のStringValue とする。 - sourceText を
一致したソーステキスト （AsyncFunctionDeclaration ）とする。 - F を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (F, name) を実行する。- F を返す。
- sourceText を
一致したソーステキスト （AsyncFunctionDeclaration ）とする。 - F を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (F,"default" ) を実行する。- F を返す。
15.8.3 実行時意味論: InstantiateAsyncFunctionExpression
- name が存在しなければ、name を
"" に設定する。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
一致したソーステキスト （AsyncFunctionExpression ）とする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- closure を返す。
Assert : name は存在しない。- name を
BindingIdentifier のStringValue に設定する。 - outerEnv を
実行中の実行コンテキスト の LexicalEnvironment とする。 - funcEnv を
NewDeclarativeEnvironment (outerEnv) とする。 - ! funcEnv.CreateImmutableBinding(name,
false ) を実行する。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
一致したソーステキスト （AsyncFunctionExpression ）とする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , funcEnv, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- ! funcEnv.InitializeBinding(name, closure) を実行する。
- closure を返す。
15.8.4 実行時意味論: EvaluateAsyncFunctionBody
- promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - completion を
Completion (FunctionDeclarationInstantiation (functionObject, argumentsList)) とする。 - completion が
異常完了 の場合、- !
Call (promiseCapability.[[Reject]],undefined , « completion.[[Value]] ») を実行する。
- !
- それ以外の場合、
AsyncFunctionStart (promiseCapability,FunctionBody ) を実行する。
ReturnCompletion (promiseCapability.[[Promise]]) を返す。
15.8.5 実行時意味論: 評価
- exprRef を ?
Evaluation （UnaryExpression ）とする。 - value を ?
GetValue (exprRef) とする。 - ?
Await (value) を返す。
15.9 非同期アロー関数定義
構文
補助構文
以下の生成規則インスタンスを処理する際
15.9.1 静的セマンティクス: 早期エラー
AsyncArrowBindingIdentifier のBoundNames の各要素がAsyncConciseBody のLexicallyDeclaredNames にも含まれている場合、構文エラーとなります。
CoverCallExpressionAndAsyncArrowHead はmust cover AsyncArrowHead を含んでいなければなりません。CoverCallExpressionAndAsyncArrowHead のContains YieldExpression がtrue の場合、構文エラーとなります。CoverCallExpressionAndAsyncArrowHead のContains AwaitExpression がtrue の場合、構文エラーとなります。CoverCallExpressionAndAsyncArrowHead のBoundNames の各要素がAsyncConciseBody のLexicallyDeclaredNames にも含まれている場合、構文エラーとなります。AsyncConciseBodyContainsUseStrict （AsyncConciseBody ）がtrue かつIsSimpleParameterList （CoverCallExpressionAndAsyncArrowHead ）がfalse の場合、構文エラーとなります。
15.9.2 静的セマンティクス: AsyncConciseBodyContainsUseStrict
false を返す。
15.9.3 実行時意味論: EvaluateAsyncConciseBody
- promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - completion を
Completion (FunctionDeclarationInstantiation (functionObject, argumentsList)) とする。 - completion が
異常完了 の場合、- !
Call (promiseCapability.[[Reject]],undefined , « completion.[[Value]] ») を実行する。
- !
- それ以外の場合、
AsyncFunctionStart (promiseCapability,ExpressionBody ) を実行する。
ReturnCompletion (promiseCapability.[[Promise]]) を返す。
15.9.4 実行時意味論: InstantiateAsyncArrowFunctionExpression
- name が存在しなければ、name を
"" に設定する。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
一致したソーステキスト （AsyncArrowFunction ）とする。 - parameters を
AsyncArrowBindingIdentifier とする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, parameters,AsyncConciseBody ,lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- closure を返す。
- name が存在しなければ、name を
"" に設定する。 - env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - privateEnv を
実行中の実行コンテキスト の PrivateEnvironment とする。 - sourceText を
一致したソーステキスト （AsyncArrowFunction ）とする。 - head を
AsyncArrowHead （CoverCallExpressionAndAsyncArrowHead でカバーされている もの）とする。 - parameters を head の
ArrowFormalParameters とする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, parameters,AsyncConciseBody ,lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- closure を返す。
15.9.5 実行時意味論: 評価
15.10 タイル位置呼び出し
15.10.1 静的セマンティクス: IsInTailPosition ( call )
抽象操作 IsInTailPosition は引数 call（
IsStrict (call) がfalse の場合、false を返す。- call が
FunctionBody 、ConciseBody 、またはAsyncConciseBody のいずれかに含まれていない場合、false を返す。 - body を call を最も近く含んでいる
FunctionBody 、ConciseBody 、またはAsyncConciseBody とする。 - body が
FunctionBody のGeneratorBody である場合、false を返す。 - body が
FunctionBody のAsyncFunctionBody である場合、false を返す。 - body が
FunctionBody のAsyncGeneratorBody である場合、false を返す。 - body が
AsyncConciseBody である場合、false を返す。 HasCallInTailPosition を body および引数 call で呼び出した結果を返す。
15.10.2 静的セマンティクス: HasCallInTailPosition
呼び出し結果の return
以下の生成規則に分割して定義されています:
- has を
HasCallInTailPosition （StatementList 、引数 call）の結果とする。 - has が
true の場合、true を返す。 HasCallInTailPosition （StatementListItem 、引数 call）の結果を返す。
false を返す。
- has を、最初の
Statement および引数 call を使ってHasCallInTailPosition の結果とする。 - has が
true の場合、true を返す。 - 2番目の
Statement および引数 call を使ってHasCallInTailPosition の結果を返す。
HasCallInTailPosition をStatement および引数 call で呼び出した結果を返す。
HasCallInTailPosition をLabelledItem および引数 call で呼び出した結果を返す。
HasCallInTailPosition をExpression および引数 call で呼び出した結果を返す。
HasCallInTailPosition をCaseBlock および引数 call で呼び出した結果を返す。
- has を
false とする。 - 最初の
CaseClauses が存在する場合、has を最初のCaseClauses および引数 call でHasCallInTailPosition を呼び出した結果とする。 - has が
true の場合、true を返す。 - has を
DefaultClause および引数 call でHasCallInTailPosition を呼び出した結果とする。 - has が
true の場合、true を返す。 - 2番目の
CaseClauses が存在する場合、has を2番目のCaseClauses および引数 call でHasCallInTailPosition を呼び出した結果とする。 - has を返す。
- has を
CaseClauses および引数 call でHasCallInTailPosition を呼び出した結果とする。 - has が
true の場合、true を返す。 HasCallInTailPosition をCaseClause および引数 call で呼び出した結果を返す。
StatementList が存在する場合、HasCallInTailPosition をStatementList および引数 call で呼び出した結果を返す。false を返す。
HasCallInTailPosition をCatch および引数 call で呼び出した結果を返す。
HasCallInTailPosition をFinally および引数 call で呼び出した結果を返す。
HasCallInTailPosition をBlock および引数 call で呼び出した結果を返す。
false を返す。
HasCallInTailPosition をAssignmentExpression および引数 call で呼び出した結果を返す。
- has を最初の
AssignmentExpression および引数 call でHasCallInTailPosition を呼び出した結果とする。 - has が
true の場合、true を返す。 - 2番目の
AssignmentExpression および引数 call でHasCallInTailPosition を呼び出した結果を返す。
HasCallInTailPosition をBitwiseORExpression および引数 call で呼び出した結果を返す。
HasCallInTailPosition をLogicalANDExpression および引数 call で呼び出した結果を返す。
HasCallInTailPosition をBitwiseORExpression および引数 call で呼び出した結果を返す。
- この
CallExpression が call である場合、true を返す。 false を返す。
HasCallInTailPosition をOptionalChain および引数 call で呼び出した結果を返す。
false を返す。
- この
OptionalChain が call である場合、true を返す。 false を返す。
- この
MemberExpression が call である場合、true を返す。 false を返す。
- expr を
ParenthesizedExpression であり、CoverParenthesizedExpressionAndArrowParameterList によってカバーされている ものとする。 HasCallInTailPosition を expr および引数 call で呼び出した結果を返す。
HasCallInTailPosition をExpression および引数 call で呼び出した結果を返す。
15.10.3 PrepareForTailCall ( )
抽象操作 PrepareForTailCall は引数を取らず、
Assert : 現在のexecution context は、その後 ECMAScript コードや組み込み関数の評価には使用されない。 この抽象操作の呼び出し後に Call が呼び出された場合、評価の前に新しいexecution context が作成・プッシュされる。- 現在の
execution context に関連するすべてのリソースを破棄する。 unused を返す。
タイル位置呼び出しは、ターゲット関数の呼び出し前に現在実行中の関数
例えば、タイル位置呼び出しでは、ターゲット関数のアクティベーションレコードのサイズが呼び出し元関数のそれを超える分だけ、実装のアクティベーションレコードスタックが増加すべきである。ターゲット関数のアクティベーションレコードが小さい場合、スタックの合計サイズは減少するはずである。
16 ECMAScript言語：スクリプトとモジュール
16.1 スクリプト
構文
16.1.1 静的セマンティクス：早期エラー
-
ScriptBody のLexicallyDeclaredNames に重複したエントリが含まれている場合、構文エラーとなる。 -
ScriptBody のLexicallyDeclaredNames の要素のいずれかがScriptBody のVarDeclaredNames にも存在する場合、構文エラーとなる。
-
StatementList Contains superを含む場合、かつそのsuperを含むソーステキストが直接eval コードで処理されていない場合、構文エラーとなる。superに関する追加の早期エラー 規則は直接eval 内で19.2.1.1 に定義されている。 -
StatementList Contains NewTarget を含む場合、かつそのNewTarget を含むソーステキストが直接eval コードで処理されていない場合、構文エラーとなる。NewTarget に関する追加の早期エラー 規則は直接eval 内で19.2.1.1 に定義されている。 -
ContainsDuplicateLabels のStatementList に引数 « » を指定した結果がtrue の場合、構文エラーとなる。 -
ContainsUndefinedBreakTarget のStatementList に引数 « » を指定した結果がtrue の場合、構文エラーとなる。 -
ContainsUndefinedContinueTarget のStatementList に引数 « » および « » を指定した結果がtrue の場合、構文エラーとなる。 -
AllPrivateIdentifiersValid のStatementList に引数 « » を指定した結果がfalse であり、かつScriptBody を含むソーステキストが直接eval コードで処理されていない場合、構文エラーとなる。
16.1.2 静的セマンティクス：ScriptIsStrict
ScriptBody が存在し、かつそのDirective Prologue にUse Strict Directive が含まれる場合、true を返す。そうでなければfalse を返す。
16.1.3 実行時セマンティクス：評価
undefined を返す。
16.1.4 スクリプトレコード
スクリプトレコードは評価されるスクリプトに関する情報をカプセル化する。各スクリプトレコードは
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[Realm]] |
|
このスクリプトが作成された |
| [[ECMAScriptCode]] |
|
このスクリプトのソーステキストをパースした結果。 |
| [[LoadedModules]] |
|
このスクリプトがインポートした識別子文字列から解決された |
| [[HostDefined]] |
任意（デフォルト値は |
|
16.1.5 ParseScript ( sourceText, realm, hostDefined )
抽象操作 ParseScript は引数 sourceText（
実装は、スクリプトソーステキストをパースし、ParseScriptの評価前に早期エラー条件を分析してもよい。ただし、エラーの報告はこの仕様が実際にそのソーステキストにParseScriptを実行する時点まで遅延しなければならない。
16.1.6 ScriptEvaluation ( scriptRecord )
抽象操作 ScriptEvaluation は引数 scriptRecord（
- globalEnv を scriptRecord.[[Realm]].[[GlobalEnv]] とする。
- scriptContext を新しい
ECMAScriptコード実行コンテキスト とする。 - scriptContext のFunctionを
null に設定する。 - scriptContext の
Realm を scriptRecord.[[Realm]] に設定する。 - scriptContext のScriptOrModuleを scriptRecord に設定する。
- scriptContext のVariableEnvironmentを globalEnv に設定する。
- scriptContext のLexicalEnvironmentを globalEnv に設定する。
- scriptContext のPrivateEnvironmentを
null に設定する。 実行中の実行コンテキスト を中断する（Suspend）。- scriptContext を
実行コンテキストスタック にプッシュする。scriptContext が新たな実行中の実行コンテキスト となる。 - script を scriptRecord.[[ECMAScriptCode]] とする。
- result を
Completion (GlobalDeclarationInstantiation (script, globalEnv)) の結果とする。 - result が
通常の完了 である場合、- result を
Completion (Evaluation (script)) の結果とする。 - result が
通常の完了 であり、 result.[[Value]] がempty の場合、- result を
NormalCompletion (undefined ) の結果とする。
- result を
- result を
- scriptContext を中断し、
実行コンテキストスタック から削除する。 Assert :実行コンテキストスタック が空でないことを確認する。実行コンテキストスタック の現在トップにあるコンテキストを実行中の実行コンテキスト として再開する（Resume）。- ? result を返す。
16.1.7 GlobalDeclarationInstantiation ( script, env )
抽象操作 GlobalDeclarationInstantiation は引数 script（
スクリプト評価のために
呼び出されたとき、以下の手順を実行する：
- lexNames を script の
LexicallyDeclaredNames の結果とする。 - varNames を script の
VarDeclaredNames の結果とする。 - lexNames の各 name について、以下を実行する：
HasLexicalDeclaration (env, name) がtrue の場合、SyntaxError 例外をthrowする。- hasRestrictedGlobal を ?
HasRestrictedGlobalProperty (env, name) の結果とする。 - 注：グローバル
varおよびfunctionバインディング（非厳格直接eval で導入されたものを除く）は、設定不可（non-configurable）であり、したがって制限付きグローバルプロパティとなる。 - hasRestrictedGlobal が
true の場合、SyntaxError 例外をthrowする。
- varNames の各 name について、以下を実行する：
HasLexicalDeclaration (env, name) がtrue の場合、SyntaxError 例外をthrowする。
- varDeclarations を script の
VarScopedDeclarations の結果とする。 - functionsToInitialize を新しい空の
List とする。 - declaredFunctionNames を新しい空の
List とする。 - varDeclarations の各 d について、逆順で以下を実行する：
- d が
VariableDeclaration 、ForBinding 、BindingIdentifier のいずれでもない場合、以下を実行する：Assert : d はFunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである。- 注：同じ名前の関数宣言が複数ある場合、最後の宣言が使用される。
- fn を d の
BoundNames の唯一の要素とする。 - declaredFunctionNames に fn が含まれていない場合、以下を実行する：
- fnDefinable を ?
CanDeclareGlobalFunction (env, fn) の結果とする。 - fnDefinable が
false の場合、TypeError 例外をthrowする。 - fn を declaredFunctionNames に追加する。
- d を functionsToInitialize の先頭に挿入する。
- fnDefinable を ?
- d が
- declaredVarNames を新しい空の
List とする。 - varDeclarations の各 d について、以下を実行する：
- d が
VariableDeclaration 、ForBinding 、BindingIdentifier のいずれかである場合、以下を実行する：- d の
BoundNames の各文字列 vn について、以下を実行する：- declaredFunctionNames に vn
が含まれていない場合、以下を実行する：
- vnDefinable を ?
CanDeclareGlobalVar (env, vn) の結果とする。 - vnDefinable が
false の場合、TypeError 例外をthrowする。 - declaredVarNames に vn
が含まれていない場合、以下を実行する：
- vn を declaredVarNames に追加する。
- vnDefinable を ?
- declaredFunctionNames に vn
が含まれていない場合、以下を実行する：
- d の
- d が
- 注：グローバルオブジェクトが
通常のオブジェクト の場合、このアルゴリズムステップ以降は異常終了は発生しない。ただし、グローバルオブジェクトがProxyエキゾチックオブジェクト の場合、以下のいくつかのステップで異常終了が発生することがある。 - 注：付録
B.3.2.2 でこのポイントに追加のステップが挿入される。 - lexDeclarations を script の
LexicallyScopedDeclarations の結果とする。 - privateEnv を
null とする。 - lexDeclarations の各 d について、以下を実行する：
- 注：レキシカル宣言名はここでインスタンス化されるが、初期化はされない。
- d の
BoundNames の各 dn について、以下を実行する：IsConstantDeclaration の結果がtrue であれば、以下を実行する：- ? env.CreateImmutableBinding(dn,
true ) を行う。
- ? env.CreateImmutableBinding(dn,
- そうでなければ、以下を実行する：
- ? env.CreateMutableBinding(dn,
false ) を行う。
- ? env.CreateMutableBinding(dn,
- functionsToInitialize の各
構文ノード f について、以下を実行する：- fn を f の
BoundNames の唯一の要素とする。 - fo を
InstantiateFunctionObject (f, env, privateEnv) の結果とする。 - ?
CreateGlobalFunctionBinding (env, fn, fo,false ) を行う。
- fn を f の
- declaredVarNames の各文字列 vn について、以下を実行する：
- ?
CreateGlobalVarBinding (env, vn,false ) を行う。
- ?
unused を返す。
明示的なvarやfunction宣言とは異なり、グローバルオブジェクト上に直接作成されたプロパティは、let/const/class宣言によってシャドウされるグローバルバインディングとなる場合がある。
16.2 モジュール
構文
16.2.1 モジュールのセマンティクス
16.2.1.1 静的セマンティクス：早期エラー
-
ModuleItemList のLexicallyDeclaredNames に重複したエントリが含まれている場合、構文エラーとなる。 -
ModuleItemList のLexicallyDeclaredNames の要素のいずれかがModuleItemList のVarDeclaredNames にも存在する場合、構文エラーとなる。 -
ModuleItemList のExportedNames に重複したエントリが含まれている場合、構文エラーとなる。 -
ModuleItemList のExportedBindings の要素のいずれかがModuleItemList のVarDeclaredNames またはModuleItemList のLexicallyDeclaredNames のいずれにも存在しない場合、構文エラーとなる。 -
ModuleItemList Contains superを含む場合、構文エラーとなる。 -
ModuleItemList Contains NewTarget を含む場合、構文エラーとなる。 -
ContainsDuplicateLabels のModuleItemList に引数 « » を指定した結果がtrue の場合、構文エラーとなる。 -
ContainsUndefinedBreakTarget のModuleItemList に引数 « » を指定した結果がtrue の場合、構文エラーとなる。 -
ContainsUndefinedContinueTarget のModuleItemList に引数 « » および « » を指定した結果がtrue の場合、構文エラーとなる。 -
AllPrivateIdentifiersValid のModuleItemList に引数 « » を指定した結果がfalse の場合、構文エラーとなる。
export default
-
StringLiteral のSV に対してIsStringWellFormedUnicode の結果がfalse の場合、構文エラーとなる。
16.2.1.2 静的セマンティクス: ImportedLocalNames ( importEntries )
抽象操作 ImportedLocalNames は、引数 importEntries（
- localNames を新しい空の
List とする。 - importEntries の各
ImportEntry Record i について、以下を実行する：- i.[[LocalName]] を localNames に追加する。
- localNames を返す。
16.2.1.3 ModuleRequest レコード
ModuleRequest Record は、指定された import 属性を持つモジュールの import 要求を表す。次のフィールドを持つ：
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[Specifier]] | 文字列 | モジュールの識別子 |
| [[Attributes]] |
|
import 属性 |
LoadedModuleRequest Record は、モジュールの import 要求と、その import 要求に対応する
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[Specifier]] | 文字列 | モジュールの識別子 |
| [[Attributes]] |
|
import 属性 |
| [[Module]] |
|
この import 要求に対応する読み込まれたモジュール |
ImportAttribute Record は、次のフィールドを持つ：
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[Key]] | 文字列 | 属性のキー |
| [[Value]] | 文字列 | 属性の値 |
16.2.1.3.1 ModuleRequestsEqual ( left, right )
抽象操作 ModuleRequestsEqual は、引数 left（
- left.[[Specifier]] が right.[[Specifier]] と異なる場合、
false を返す。 - leftAttrs を left.[[Attributes]] とする。
- rightAttrs を right.[[Attributes]] とする。
- leftAttrsCount を leftAttrs の要素数とする。
- rightAttrsCount を rightAttrs の要素数とする。
- leftAttrsCount ≠ rightAttrsCount
の場合、
false を返す。 - leftAttrs の各
ImportAttribute Record l について、以下を実行する：- rightAttrs に l.[[Key]] が
r.[[Key]] であり、かつ l.[[Value]] が r.[[Value]] である
ImportAttribute Record r が含まれていない場合、false を返す。
- rightAttrs に l.[[Key]] が
r.[[Key]] であり、かつ l.[[Value]] が r.[[Value]] である
true を返す。
16.2.1.4 静的セマンティクス：ModuleRequests
List の新しい空リストを返す。
ModuleItem のModuleRequests を返す。
- requests を
ModuleItemList のModuleRequests の結果とする。 - additionalRequests を
ModuleItem のModuleRequests の結果とする。 - additionalRequests の各
ModuleRequest Record mr について、以下を実行する：- requests に mr2（
ModuleRequest Record ）でModuleRequestsEqual (mr, mr2) がtrue となるものが含まれていない場合、以下を実行：- mr を requests に追加する。
- requests に mr2（
- requests を返す。
List の新しい空リストを返す。
- specifier を
FromClause のSV の結果とする。 - 唯一の要素として
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » } を持つList を返す。
- specifier を
FromClause のSV の結果とする。 - attributes を
WithClause のWithClauseToAttributes の結果とする。 - 唯一の要素として
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attributes } を持つList を返す。
- specifier を
ModuleSpecifier のSV の結果とする。 - 唯一の要素として
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » } を持つList を返す。
- specifier を
ModuleSpecifier のSV の結果とする。 - attributes を
WithClause のWithClauseToAttributes の結果とする。 - 唯一の要素として
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attributes } を持つList を返す。
- specifier を
FromClause のSV の結果とする。 - 唯一の要素として
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » } を持つList を返す。
- specifier を
FromClause のSV の結果とする。 - attributes を
WithClause のWithClauseToAttributes の結果とする。 - 唯一の要素として
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attributes } を持つList を返す。
List の新しい空リストを返す。
16.2.1.5 抽象モジュールレコード
モジュールレコードは、単一のモジュールのインポートおよびエクスポートに関する構造的情報をカプセル化する。この情報は、接続されたモジュール群のインポートとエクスポートをリンクするために使用される。モジュールレコードには、モジュールの評価時のみ使用される4つのフィールドが含まれる。
仕様上、モジュールレコード値は
Module Recordは
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[Realm]] |
|
このモジュールが作成された |
| [[Environment]] |
|
このモジュールのトップレベルバインディングを含む |
| [[Namespace]] |
オブジェクトまたは |
このモジュール用に作成された場合のモジュール名前空間オブジェクト（ |
| [[HostDefined]] |
任意（デフォルト値は |
|
| メソッド | 目的 |
|---|---|
| LoadRequestedModules([hostDefined]) |
モジュールをリンクするために、依存関係を再帰的に読み込み、Promiseを返す。 |
| GetExportedNames([exportStarSet]) |
このモジュールから直接または間接的にエクスポートされるすべての名前のリストを返す。 このメソッドを呼び出す前に LoadRequestedModules が正常に完了している必要がある。 |
| ResolveExport(exportName [, resolveSet]) |
このモジュールによってエクスポートされた名前のバインディングを返す。バインディングは ResolvedBinding
Record（{ [[Module]]:
この操作は、特定の exportName と resolveSet の組み合わせで呼び出された際、同じ結果を返さなければならない。 このメソッドを呼び出す前に LoadRequestedModules が正常に完了している必要がある。 |
| Link() |
モジュールを評価する準備として、すべての依存関係を推移的に解決し、 このメソッドを呼び出す前に LoadRequestedModules が正常に完了している必要がある。 |
| Evaluate() |
このモジュールと依存関係の評価のPromiseを返す。評価が成功するか、すでに成功していればresolveされ、評価エラーが発生するか、すでに失敗していればrejectされる。Promiseがrejectされた場合、 このメソッドを呼び出す前に Link が正常に完了している必要がある。 |
16.2.1.5.1 EvaluateModuleSync ( module )
抽象操作 EvaluateModuleSync は module（
Assert : module はCyclic Module Record ではない。- promise を module.Evaluate() の結果とする。
Assert : promise.[[PromiseState]] はfulfilled またはrejected のいずれかである。- promise.[[PromiseState]] が
rejected の場合、以下を実行する：- promise.[[PromiseIsHandled]] が
false の場合、HostPromiseRejectionTracker (promise,"handle" ) を実行する。 - promise.[[PromiseIsHandled]] を
true に設定する。 ThrowCompletion (promise.[[PromiseResult]]) を返す。
- promise.[[PromiseIsHandled]] が
unused を返す。
16.2.1.6 순환 모듈 레코드
순환 모듈
레코드는
| 필드 이름 | 값 타입 | 의미 |
|---|---|---|
| [[Status]] |
|
처음에는 |
| [[EvaluationError]] |
|
평가 중 발생한 예외를 나타내는 |
| [[DFSAncestorIndex]] |
|
Link 및 Evaluate 중에만 사용하는 보조 필드입니다. [[Status]]가
|
| [[RequestedModules]] |
|
이 모듈의 import와 연관된 |
| [[LoadedModules]] |
|
이 레코드가 나타내는 모듈이 상대적 import 속성을 가지고 모듈을 import 요청할 때 사용한 specifier 문자열에서
|
| [[CycleRoot]] |
|
사이클 내에서 처음 방문한 모듈, 강하게 연결된 구성 요소의 루트 DFS 조상입니다. 사이클에 속하지 않은 모듈의 경우 자신이 됩니다. Evaluate가 완료된 후, 모듈의 [[DFSAncestorIndex]]는 [[CycleRoot]]의 깊이 우선 탐색 인덱스가 됩니다. |
| [[HasTLA]] | Boolean |
이 모듈이 개별적으로 비동기적인지 여부(예: 최상위 await가 포함된 |
| [[AsyncEvaluationOrder]] |
|
이 필드는 처음에 |
| [[TopLevelCapability]] |
|
이 모듈이 어떤 사이클의 [[CycleRoot]]이고, 그 사이클의 모듈 중 하나에
대해 Evaluate()가 호출된 경우, 이 필드는 전체 평가에 대한 |
| [[AsyncParentModules]] |
|
이 모듈 또는 의존성이 [[HasTLA]]
|
| [[PendingAsyncDependencies]] |
|
이 모듈에 비동기 의존성이 있으면, 이 필드는 해당 모듈이 실행될 때까지 남은 비동기 의존성 모듈의 수를 추적합니다. 비동기 의존성이 있는 모듈은 이 값이 0이 되고 실행 오류가 없을 때 실행됩니다. |
| 메서드 | 목적 |
|---|---|
| InitializeEnvironment() |
모듈의 |
| ExecuteModule([promiseCapability]) |
모듈의 코드를 해당 |
GraphLoadingState 레코드는 모듈 그래프의 로딩 과정에 대한 정보를 담고 있는
| 필드 이름 | 값 타입 | 의미 |
|---|---|---|
| [[PromiseCapability]] |
|
로딩 과정이 완료될 때 resolve할 promise입니다. |
| [[IsLoading]] | Boolean | 로딩 과정이 아직 성공적으로 또는 오류로 끝나지 않은 경우 true입니다. |
| [[PendingModulesCount]] |
음이 아닌 |
|
| [[Visited]] |
|
현재 로딩 과정에서 이미 로드된 |
| [[HostDefined]] |
아무 값이나 (기본값은 |
|
16.2.1.6.1 モジュールレコード抽象メソッドの実装
以下は、
16.2.1.6.1.1 LoadRequestedModules ( [hostDefined ] )
- もし hostDefined が存在しなければ、hostDefined を
empty とする。 - pc を !
NewPromiseCapability (%Promise% ) とする。 - state を
GraphLoadingState レコード { [[IsLoading]]:true , [[PendingModulesCount]]: 1, [[Visited]]: « », [[PromiseCapability]]: pc, [[HostDefined]]: hostDefined } とする。 InnerModuleLoading (state, module) を実行する。- pc.[[Promise]] を返す。
<link rel="preload" as="..."> タグにおいて、正しい fetch destination
を設定するために利用されます。
import() 式では hostDefined パラメータは決して設定されません。
16.2.1.6.1.1.1 InnerModuleLoading (state, module)
抽象操作 InnerModuleLoading は、引数 state（
アサート : state.[[IsLoading]] はtrue である。- もし module が
循環モジュールレコード であり、module.[[Status]] がnew で、かつ state.[[Visited]] に module が含まれていなければ、次を行う：- module を state.[[Visited]] に追加する。
- requestedModulesCount を module.[[RequestedModules]] の要素数とする。
- state.[[PendingModulesCount]] を state.[[PendingModulesCount]] + requestedModulesCount に設定する。
- 各
ModuleRequest レコード request について、module.[[RequestedModules]] の中で次を行う：- もし
AllImportAttributesSupported (request.[[Attributes]]) がfalse なら、次を行う：- error を
ThrowCompletion (新たに生成されたSyntaxError オブジェクト) とする。 ContinueModuleLoading (state, error) を実行する。
- error を
- それ以外で、module.[[LoadedModules]] に
LoadedModuleRequest レコード record が含まれ、かつModuleRequestsEqual (record, request) がtrue である場合、次を行う：InnerModuleLoading (state, record.[[Module]]) を実行する。
- それ以外の場合、次を行う：
HostLoadImportedModule (module, request, state.[[HostDefined]], state) を実行する。- 注：
HostLoadImportedModule はFinishLoadingImportedModule を呼び出し、ContinueModuleLoading を通じてグラフロード処理に再入します。
- もし state.[[IsLoading]] が
false なら、unused を返す。
- もし
アサート : state.[[PendingModulesCount]] ≥ 1 である。- state.[[PendingModulesCount]] を state.[[PendingModulesCount]] - 1 に設定する。
- もし state.[[PendingModulesCount]] = 0
なら、次を行う：
- state.[[IsLoading]] を
false に設定する。 - 各
循環モジュールレコード loaded について、state.[[Visited]] の中で次を行う：- もし loaded.[[Status]]
が
new なら、loaded.[[Status]] をunlinked に設定する。
- もし loaded.[[Status]]
が
- !
Call (state.[[PromiseCapability]].[[Resolve]],undefined , «undefined ») を実行する。
- state.[[IsLoading]] を
unused を返す。
16.2.1.6.1.1.2 ContinueModuleLoading (state, moduleCompletion)
抽象操作 ContinueModuleLoading は、state（
- もし state.[[IsLoading]] が
false なら、unused を返す。 - もし moduleCompletion が
normal completion なら、次を行う：InnerModuleLoading (state, moduleCompletion.[[Value]]) を実行する。
- それ以外の場合、次を行う：
- state.[[IsLoading]] を
false に設定する。 - !
Call (state.[[PromiseCapability]].[[Reject]],undefined , « moduleCompletion.[[Value]] ») を実行する。
- state.[[IsLoading]] を
unused を返す。
16.2.1.6.1.2 Link ( )
アサート : module.[[Status]] はunlinked ,linked ,evaluating-async ,evaluated のいずれかである。- stack を新たな空の
リスト とする。 - result を
Completion (InnerModuleLinking (module, stack, 0)) とする。 - もし result が
abrupt completion なら、次を行う：- 各
循環モジュールレコード m について、stack の中で次を行う：アサート : m.[[Status]] はlinking である。- m.[[Status]] を
unlinked に設定する。
アサート : module.[[Status]] はunlinked である。- ? result を返す。
- 各
アサート : module.[[Status]] はlinked ,evaluating-async ,evaluated のいずれかである。アサート : stack は空である。unused を返す。
16.2.1.6.1.2.1 InnerModuleLinking (module, stack, index)
抽象操作 InnerModuleLinking は、module（
- もし module が
循環モジュールレコード でなければ、次を行う：- ? module.Link() を実行する。
- index を返す。
- もし module.[[Status]] が
linking ,linked ,evaluating-async ,evaluated のいずれかであれば、index を返す。 アサート : module.[[Status]] はunlinked である。- module.[[Status]] を
linking に設定する。 - moduleIndex を index とする。
- module.[[DFSAncestorIndex]] を index に設定する。
- index を index + 1 に設定する。
- module を stack に追加する。
- 各
ModuleRequest Record request について、module.[[RequestedModules]] の中で次を行う：- requiredModule を
GetImportedModule (module, request) とする。 - index を ?
InnerModuleLinking (requiredModule, stack, index) に設定する。 - もし requiredModule が
循環モジュールレコード であれば、次を行う：アサート : requiredModule.[[Status]] はlinking ,linked ,evaluating-async ,evaluated のいずれかである。アサート : requiredModule.[[Status]] がlinking である場合に限り、stack は requiredModule を含む。- もし requiredModule.[[Status]] が
linking であれば、次を行う：- module.[[DFSAncestorIndex]] を
min (module.[[DFSAncestorIndex]], requiredModule.[[DFSAncestorIndex]]) に設定する。
- module.[[DFSAncestorIndex]] を
- requiredModule を
- ? module.InitializeEnvironment() を実行する。
アサート : module は stack の中にちょうど1回現れる。アサート : module.[[DFSAncestorIndex]] ≤ moduleIndex である。- もし module.[[DFSAncestorIndex]] =
moduleIndex なら、次を行う：
- done を
false とする。 - done が
false の間、繰り返す：- requiredModule を stack の最後の要素とする。
- stack の最後の要素を削除する。
アサート : requiredModule は循環モジュールレコード である。- requiredModule.[[Status]] を
linked に設定する。 - もし requiredModule および module が同じ
モジュールレコード であれば、done をtrue に設定する。
- done を
- index を返す。
16.2.1.6.1.3 Evaluate ( )
Assert : この Evaluate 呼び出しは、surrounding agent 内で他の Evaluate の呼び出しと同時に実行されていない。Assert : module.[[Status]] はlinked 、evaluating-async 、またはevaluated のいずれかである。- もし module.[[Status]] が
evaluating-async またはevaluated であれば、module を module.[[CycleRoot]] に設定する。 - もし module.[[TopLevelCapability]] が
empty でない場合、- module.[[TopLevelCapability]].[[Promise]] を返す。
- stack を新しい空の
List とする。 - capability を !
NewPromiseCapability (%Promise% ) とする。 - module.[[TopLevelCapability]] に capability を設定する。
- result を
Completion (InnerModuleEvaluation (module, stack, 0)) とする。 - もし result が
abrupt completion であれば、- stack の各
循環モジュールレコード m について、次を実行する: Assert : module.[[Status]] はevaluated である。Assert : module.[[EvaluationError]] と result は同じCompletion Record である。- !
Call (capability.[[Reject]],undefined , « result.[[Value]] ») を実行する。
- stack の各
- それ以外の場合、
- capability.[[Promise]] を返す。
16.2.1.6.1.3.1 InnerModuleEvaluation ( module, stack, index )
抽象操作 InnerModuleEvaluation は、module（
- もし module が
Cyclic Module Record でない場合、- ?
EvaluateModuleSync (module) を実行する。 - index を返す。
- ?
- もし module.[[Status]] が
evaluating-async またはevaluated のいずれかの場合、- もし module.[[EvaluationError]] が
empty なら、index を返す。 - それ以外なら、? module.[[EvaluationError]] を返す。
- もし module.[[EvaluationError]] が
- もし module.[[Status]] が
evaluating なら、index を返す。 Assert : module.[[Status]] はlinked である。- module.[[Status]] を
evaluating に設定する。 - moduleIndex を index とする。
- module.[[DFSAncestorIndex]] を index に設定する。
- module.[[PendingAsyncDependencies]] を 0 に設定する。
- index を index + 1 に設定する。
- module を stack に追加する。
- module.[[RequestedModules]] の各
ModuleRequest Record request について、以下を行う:- requiredModule を
GetImportedModule (module, request) とする。 - index を ?
InnerModuleEvaluation (requiredModule, stack, index) に設定する。 - もし requiredModule が
Cyclic Module Record なら、Assert : requiredModule.[[Status]] はevaluating 、evaluating-async 、evaluated のいずれかである。Assert : requiredModule.[[Status]] がevaluating であるのは stack に requiredModule が含まれる場合に限る。- もし requiredModule.[[Status]] が
evaluating なら、- module.[[DFSAncestorIndex]] を
min (module.[[DFSAncestorIndex]], requiredModule.[[DFSAncestorIndex]]) に設定する。
- module.[[DFSAncestorIndex]] を
- それ以外なら、
- requiredModule を requiredModule.[[CycleRoot]] に設定する。
Assert : requiredModule.[[Status]] はevaluating-async またはevaluated のいずれかである。- もし requiredModule.[[EvaluationError]] が
empty でなければ、? requiredModule.[[EvaluationError]] を返す。
- もし requiredModule.[[AsyncEvaluationOrder]] が
integer なら、- module.[[PendingAsyncDependencies]] を module.[[PendingAsyncDependencies]] + 1 にする。
- module を requiredModule.[[AsyncParentModules]] に追加する。
- requiredModule を
- もし module.[[PendingAsyncDependencies]] > 0 または
module.[[HasTLA]] が
true なら、Assert : module.[[AsyncEvaluationOrder]] はunset である。- module.[[AsyncEvaluationOrder]] を
IncrementModuleAsyncEvaluationCount () に設定する。 - もし module.[[PendingAsyncDependencies]] = 0
なら、
ExecuteAsyncModule (module) を実行する。
- それ以外なら、
- ? module.ExecuteModule() を実行する。
Assert : module は stack にちょうど1回だけ現れる。Assert : module.[[DFSAncestorIndex]] ≤ moduleIndex である。- もし module.[[DFSAncestorIndex]] =
moduleIndex なら、
- done を
false とする。 - done が
false の間、繰り返す:- requiredModule を stack の最後の要素とする。
- stack の最後の要素を削除する。
Assert : requiredModule はCyclic Module Record である。Assert : requiredModule.[[AsyncEvaluationOrder]] はinteger またはunset のいずれかである。- もし requiredModule.[[AsyncEvaluationOrder]] が
unset なら、requiredModule.[[Status]] をevaluated に設定する。 - それ以外なら、requiredModule.[[Status]] を
evaluating-async に設定する。 - もし requiredModule と module が同じ
Module Record なら、done をtrue に設定する。 - requiredModule.[[CycleRoot]] を module に設定する。
- done を
- index を返す。
InnerModuleEvaluation によって走査されている間、モジュールは
非同期サイクルのモジュールに依存する他のモジュールは、そのサイクルが
16.2.1.6.1.3.2 ExecuteAsyncModule ( module )
抽象操作 ExecuteAsyncModule は、引数 module（
Assert : module.[[Status]] はevaluating またはevaluating-async のいずれかである。Assert : module.[[HasTLA]] はtrue である。- capability を !
NewPromiseCapability (%Promise% ) とする。 - fulfilledClosure を、パラメータなしで module
をキャプチャし、呼び出された時に以下を実行する新しい
Abstract Closure とする：AsyncModuleExecutionFulfilled (module) を実行する。NormalCompletion (undefined ) を返す。
- onFulfilled を
CreateBuiltinFunction (fulfilledClosure, 0,"" , « ») とする。 - rejectedClosure を、パラメータ (error) で
module をキャプチャし、呼び出された時に以下を実行する新しい
Abstract Closure とする：AsyncModuleExecutionRejected (module, error) を実行する。NormalCompletion (undefined ) を返す。
- onRejected を
CreateBuiltinFunction (rejectedClosure, 0,"" , « ») とする。 PerformPromiseThen (capability.[[Promise]], onFulfilled, onRejected) を実行する。- ! module.ExecuteModule(capability) を実行する。
unused を返す。
16.2.1.6.1.3.3 GatherAvailableAncestors ( module, execList )
抽象操作 GatherAvailableAncestors は、引数 module（
- module.[[AsyncParentModules]] の各
循環モジュールレコード m について、以下を行う：- もし execList に m が含まれておらず、かつ
m.[[CycleRoot]].[[EvaluationError]] が
empty であれば、以下を行う：Assert : m.[[Status]] はevaluating-async である。Assert : m.[[EvaluationError]] はempty である。Assert : m.[[AsyncEvaluationOrder]] はinteger である。Assert : m.[[PendingAsyncDependencies]] > 0 である。- m.[[PendingAsyncDependencies]] を m.[[PendingAsyncDependencies]] - 1 に設定する。
- もし m.[[PendingAsyncDependencies]] = 0
なら、以下を行う：
- m を execList に追加する。
- もし m.[[HasTLA]] が
false であれば、GatherAvailableAncestors (m, execList) を実行する。
- もし execList に m が含まれておらず、かつ
m.[[CycleRoot]].[[EvaluationError]] が
unused を返す。
ルート module の非同期実行が完了したとき、この関数は同期的に一緒に実行可能なモジュールのリストを決定し、execList に追加する。
16.2.1.6.1.3.4 AsyncModuleExecutionFulfilled ( module )
抽象操作 AsyncModuleExecutionFulfilled は、引数 module（
- もし module.[[Status]] が
evaluated なら、Assert : module.[[EvaluationError]] はempty ではない。unused を返す。
Assert : module.[[Status]] はevaluating-async である。Assert : module.[[AsyncEvaluationOrder]] はinteger である。Assert : module.[[EvaluationError]] はempty である。- module.[[AsyncEvaluationOrder]] を
done に設定する。 - module.[[Status]] を
evaluated に設定する。 - もし module.[[TopLevelCapability]] が
empty でなければ、Assert : module.[[CycleRoot]] と module は同じModule Record である。- !
Call (module.[[TopLevelCapability]].[[Resolve]],undefined , «undefined ») を実行する。
- execList を新しい空の
List とする。 GatherAvailableAncestors (module, execList) を実行する。Assert : execList の全要素は、その [[AsyncEvaluationOrder]] フィールドがinteger に設定され、[[PendingAsyncDependencies]] フィールドが 0 に設定され、[[EvaluationError]] フィールドがempty である。- sortedExecList を、execList の要素を [[AsyncEvaluationOrder]] フィールドで昇順にソートした
List とする。 - sortedExecList の各
循環モジュールレコード m について、以下を行う：- もし m.[[Status]] が
evaluated なら、Assert : m.[[EvaluationError]] はempty ではない。
- それ以外で m.[[HasTLA]] が
true なら、ExecuteAsyncModule (m) を実行する。
- それ以外の場合、
- result を m.ExecuteModule() とする。
- もし result が
abrupt completion であれば、AsyncModuleExecutionRejected (m, result.[[Value]]) を実行する。
- それ以外の場合、
- m.[[AsyncEvaluationOrder]]
を
done に設定する。 - m.[[Status]]
を
evaluated に設定する。 - もし m.[[TopLevelCapability]] が
empty でなければ、Assert : m.[[CycleRoot]] と m は同じModule Record である。- !
Call (m.[[TopLevelCapability]].[[Resolve]],undefined , «undefined ») を実行する。
- m.[[AsyncEvaluationOrder]]
を
- もし m.[[Status]] が
unused を返す。
16.2.1.6.1.3.5 AsyncModuleExecutionRejected ( module, error )
抽象操作 AsyncModuleExecutionRejected は、module（
- もし module.[[Status]] が
evaluated なら、Assert : module.[[EvaluationError]] はempty ではない。unused を返す。
Assert : module.[[Status]] はevaluating-async である。Assert : module.[[AsyncEvaluationOrder]] はinteger である。Assert : module.[[EvaluationError]] はempty である。- module.[[EvaluationError]] を
ThrowCompletion (error) に設定する。 - module.[[Status]] を
evaluated に設定する。 - module.[[AsyncEvaluationOrder]] を
done に設定する。 - 注: module.[[AsyncEvaluationOrder]] は
AsyncModuleExecutionFulfilled との対称性のためdone に設定される。InnerModuleEvaluation では、モジュールの [[EvaluationError]] がempty でない場合、[[AsyncEvaluationOrder]] の値は使用されない。 - module.[[AsyncParentModules]] の各
循環モジュールレコード m について、以下を実行する：AsyncModuleExecutionRejected (m, error) を実行する。
- もし module.[[TopLevelCapability]] が
empty でなければ、Assert : module.[[CycleRoot]] と module は同じModule Record である。- !
Call (module.[[TopLevelCapability]].[[Reject]],undefined , « error ») を実行する。
unused を返す。
16.2.1.6.2 循環モジュールレコードグラフの例
この非規範的なセクションでは、いくつかの一般的なモジュールグラフのリンクおよび評価の一連の例を示し、特にエラーがどのように発生するかに焦点を当てます。
まず、次のシンプルなモジュールグラフを考えます。
まず、エラー条件がないと仮定します。
次に、リンクエラーを含むケースを考えます。A.LoadRequestedModules() の正常な呼び出し後、
最後に、Link() の正常な呼び出し後の評価エラーのケースを考えます。
次に、異なる種類のエラー条件を考えます：
このシナリオでは、モジュール A が他のモジュールへの依存関係を宣言していますが、そのモジュールの
ここでの読み込み、リンク、評価エラーの違いは、次の特徴によるものです：
Evaluation は一度だけ実行されなければならず、副作用が発生する可能性があるため、評価が既に行われたかどうか（失敗も含めて）を記憶しておくことが重要です。（エラーの場合も例外を記憶するのが理にかなっており、そうでないと Evaluate() の後続呼び出しごとに新しい例外を生成しなければならなくなります。）- 一方、リンクは副作用がなく、失敗しても後で何度でも再試行可能です。
- 読み込みは
ホスト と密接に連携しており、例えば一時的なネットワーク障害などで失敗した場合、いくつかのホストでは失敗した読み込みの再試行をユーザーに許可することが望ましい場合があります。
次に、循環を含むモジュールグラフを考えます：
ここでは、エントリーポイントがモジュール A であると仮定します。
その後、
循環モジュールグラフの評価フェーズでも、成功ケースでは同様の処理が行われます。
次に、A にリンクエラーがあるケースを考えます。例えば、C
から存在しない束縛をインポートしようとした場合です。この場合、上記の処理は依然として行われますが、A への2度目の
または、A
に評価エラーがあるケースを考えます。例えば、そのソースコードが例外を投げる場合です。この場合、上記の評価時のアナロジーの処理が行われますが、A
への2度目の await
を含む、またはそれに依存するモジュールのチェーンを形成し、依存グラフ全体で
最後に、すべてのモジュールが非同期的に完了するサイクルを含むモジュールグラフを考えます：
読み込みとリンクはこれまで通り行われ、すべてのモジュールの [[Status]] は
A.Evaluate() を呼び出すと、
|
フィールド
|
A | B | C | D | E |
|---|---|---|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 | 0 | 0 | 4 |
| [[Status]] | |||||
| [[AsyncEvaluationOrder]] | 4 | 1 | 3 | 0 | 2 |
| [[AsyncParentModules]] | « » | « A » | « A » | « B, C » | « C » |
| [[PendingAsyncDependencies]] | 2 (B と C) | 1 (D) | 2 (D と E) | 0 | 0 |
ここで、E が最初に実行完了すると仮定します。その場合、
|
フィールド
|
C | E |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 4 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 3 | |
| [[AsyncParentModules]] | « A » | « C » |
| [[PendingAsyncDependencies]] | 1 (D) | 0 |
次に D が実行完了します（実行中だった唯一のモジュール）。このとき await が含まれる場合は並行で実行される可能性あり）。更新後の各モジュールのフィールドは
|
フィールド
|
B | C | D |
|---|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 | 0 |
| [[Status]] | |||
| [[AsyncEvaluationOrder]] | 1 | 3 | |
| [[AsyncParentModules]] | « A » | « A » | « B, C » |
| [[PendingAsyncDependencies]] | 0 | 0 | 0 |
次に C が実行完了したと仮定します。その場合、
|
フィールド
|
A | C |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 1 (B) | 0 |
その後、B が実行完了します。その場合、
|
フィールド
|
A | B |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 0 | 0 |
最後に A が実行完了します。その場合、
|
フィールド
|
A |
|---|---|
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
または、C が実行失敗し、B の実行完了前にエラーを返すケースを考えます。その場合、
|
フィールド
|
A | C |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | ||
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 1 (B) | 0 |
| [[EvaluationError]] | C の評価エラー |
A は C と同じエラーで拒否されます。なぜなら C が
|
フィールド
|
A |
|---|---|
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
| [[EvaluationError]] | C の |
その後、B がエラーなしで実行完了します。その場合、
|
フィールド
|
A | B |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | 1 |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 0 | 0 |
| [[EvaluationError]] | C の |
16.2.1.7 ソーステキストモジュールレコード
ソーステキストモジュールレコードは、
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[ECMAScriptCode]] |
|
このモジュールのソーステキストを |
| [[Context]] |
|
このモジュールに関連付けられた |
| [[ImportMeta]] |
オブジェクトまたは |
import.metaメタプロパティを介して公開されるオブジェクト。ECMAScriptコードでアクセスされるまで |
| [[ImportEntries]] |
|
このモジュールのコードから導出されたImportEntryレコードの |
| [[LocalExportEntries]] |
|
このモジュールのコードから導出された、そのモジュール内で宣言されたものに対応するExportEntryレコードの |
| [[IndirectExportEntries]] |
|
このモジュールのコードから導出された、モジュール内で発生する再エクスポートされたインポートやexport * as namespace宣言によるエクスポートに対応するExportEntryレコードの |
| [[StarExportEntries]] |
|
このモジュールのコードから導出された、モジュール内で発生するexport *宣言(ただしexport * as namespace宣言を除く)に対応するExportEntryレコードの |
ImportEntryレコードは、
1つの宣言的インポートについての情報を要約した
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[ModuleRequest]] |
|
|
| [[ImportName]] |
文字列または |
[[ModuleRequest]]で識別されるモジュールによってエクスポートされる所望のバインディングの名前。
|
| [[LocalName]] | 文字列 | インポート元モジュール内からインポートされた値にローカルにアクセスするために使用される名前。 |
| インポート文の形式 | [[ModuleRequest]] | [[ImportName]] | [[LocalName]] |
|---|---|---|---|
import v from "mod";
|
|
|
|
import * as ns from "mod";
|
|
|
|
import {x} from "mod";
|
|
|
|
import {x as v} from "mod";
|
|
|
|
import "mod";
|
|
||
ExportEntryレコードは、
1つの宣言的エクスポートについての情報を要約した
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[ExportName]] |
文字列または |
このモジュールによってこのバインディングをエクスポートするために使用される名前。 |
| [[ModuleRequest]] |
|
|
| [[ImportName]] |
文字列、 |
[[ModuleRequest]]で識別されるモジュールによってエクスポートされる所望のバインディングの名前。
export * as ns from "mod"宣言で使用。
export * from "mod"宣言で使用。
|
| [[LocalName]] |
文字列または |
インポート元モジュール内からエクスポートされた値にローカルにアクセスするために使用される名前。
エクスポート値がモジュール内からローカルにアクセスできない場合は |
| エクスポート文の形式 | [[ExportName]] | [[ModuleRequest]] | [[ImportName]] | [[LocalName]] |
|---|---|---|---|---|
export var v;
|
|
|
|
|
export default function f() {}
|
|
|
|
|
export default function () {}
|
|
|
|
|
export default 42;
|
|
|
|
|
export {x};
|
|
|
|
|
export {v as x};
|
|
|
|
|
export {x} from "mod";
|
|
|
|
|
export {v as x} from "mod";
|
|
|
|
|
export * from "mod";
|
|
|
|
|
export * as ns from "mod";
|
|
|
|
|
以下の定義は、
16.2.1.7.1 ParseModule ( sourceText, realm, hostDefined )
抽象操作 ParseModule は、引数 sourceText（
- body を
ParseText (sourceText,Module ) とする。 - もし body がエラーの
リスト であれば、body を返す。 - requestedModules を
ModuleRequests of body とする。 - importEntries を
ImportEntries of body とする。 - importedBoundNames を
ImportedLocalNames (importEntries) とする。 - indirectExportEntries を新しい空の
リスト とする。 - localExportEntries を新しい空の
リスト とする。 - starExportEntries を新しい空の
リスト とする。 - exportEntries を
ExportEntries of body とする。 - exportEntries の各
ExportEntry Record ee について、以下を行う：- もし ee.[[ModuleRequest]] が
null なら、- もし importedBoundNames に ee.[[LocalName]] が含まれていなければ、
- ee を localExportEntries に追加する。
- それ以外の場合、
- ie を importEntries のうち [[LocalName]] が ee.[[LocalName]] である要素とする。
- もし ie.[[ImportName]]
が
namespace-object なら、- 注: これはインポートされたモジュール名前空間オブジェクトの再エクスポートである。
- ee を localExportEntries に追加する。
- それ以外の場合、
- 注: これは単一名称の再エクスポートである。
ExportEntry Record { [[ModuleRequest]]: ie.[[ModuleRequest]], [[ImportName]]: ie.[[ImportName]], [[LocalName]]:null , [[ExportName]]: ee.[[ExportName]] } を indirectExportEntries に追加する。
- もし importedBoundNames に ee.[[LocalName]] が含まれていなければ、
- それ以外で ee.[[ImportName]] が
all-but-default なら、Assert : ee.[[ExportName]] はnull である。- ee を starExportEntries に追加する。
- それ以外の場合、
- ee を indirectExportEntries に追加する。
- もし ee.[[ModuleRequest]] が
- async を body
Contains awaitとする。 - 以下を返す：
ソーステキストモジュールレコード { [[Realm]]: realm, [[Environment]]:empty , [[Namespace]]:empty , [[CycleRoot]]:empty , [[HasTLA]]: async, [[AsyncEvaluationOrder]]:unset , [[TopLevelCapability]]:empty , [[AsyncParentModules]]: « », [[PendingAsyncDependencies]]:empty , [[Status]]:new , [[EvaluationError]]:empty , [[HostDefined]]: hostDefined, [[ECMAScriptCode]]: body, [[Context]]:empty , [[ImportMeta]]:empty , [[RequestedModules]]: requestedModules, [[LoadedModules]]: « », [[ImportEntries]]: importEntries, [[LocalExportEntries]]: localExportEntries, [[IndirectExportEntries]]: indirectExportEntries, [[StarExportEntries]]: starExportEntries, [[DFSAncestorIndex]]:empty }。
実装は、ParseModule の評価前にモジュールソーステキストを構文解析し、早期エラー条件を解析してもよい。ただし、エラーの報告は、この仕様が実際にそのソーステキストに対して ParseModule を実行する時点まで遅延しなければならない。
16.2.1.7.2 モジュールレコード抽象メソッドの実装
以下は、
16.2.1.7.2.1 GetExportedNames ( [exportStarSet] )
Assert : module.[[Status]] はnew でない。- exportStarSet が未指定の場合、exportStarSet を新しい空の
リスト に設定する。 - もし exportStarSet に module が含まれていれば、
- module を exportStarSet に追加する。
- exportedNames を新しい空の
リスト とする。 - module.[[LocalExportEntries]] の各
ExportEntryレコード e について、 - module.[[IndirectExportEntries]] の各
ExportEntryレコード e について、 - module.[[StarExportEntries]] の各
ExportEntryレコード e について、Assert : e.[[ModuleRequest]] はnull でない。- requestedModule を
GetImportedModule (module, e.[[ModuleRequest]]) とする。 - starNames を requestedModule.GetExportedNames(exportStarSet) とする。
- starNames の各要素 n について、
- もし n が
"default" でなければ、- もし exportedNames に n
が含まれていなければ、
- n を exportedNames に追加する。
- もし exportedNames に n
が含まれていなければ、
- もし n が
- exportedNames を返す。
GetExportedNames は、あいまいな star エクスポートバインディング名を除外したり、例外を投げたりしない。
16.2.1.7.2.2 ResolveExport ( exportName [ , resolveSet ] )
ResolveExport
は、インポートされたバインディングを実際に定義するモジュールとローカルバインディング名へ解決しようとする。この定義モジュールは、このメソッドが呼び出された
定義モジュールが見つかった場合、
呼び出し時、以下の手順を実行する：
Assert : module.[[Status]] はnew でない。- resolveSet が未指定の場合、resolveSet を新しい空の
リスト に設定する。 - resolveSet の各
Record { [[Module]], [[ExportName]] } r について、 Record { [[Module]]: module, [[ExportName]]: exportName } を resolveSet に追加する。- module.[[LocalExportEntries]] の各
ExportEntryレコード e について、- もし e.[[ExportName]] が
exportName なら、
Assert : module はこのエクスポートの直接バインディングを提供する。ResolvedBindingレコード { [[Module]]: module, [[BindingName]]: e.[[LocalName]] } を返す。
- もし e.[[ExportName]] が
exportName なら、
- module.[[IndirectExportEntries]] の各
ExportEntryレコード e について、- もし e.[[ExportName]] が
exportName なら、
Assert : e.[[ModuleRequest]] はnull ではない。- importedModule を
GetImportedModule (module, e.[[ModuleRequest]]) とする。 - もし e.[[ImportName]] が
all なら、Assert : module はこのエクスポートの直接バインディングを提供しない。ResolvedBindingレコード { [[Module]]: importedModule, [[BindingName]]:namespace } を返す。
- それ以外の場合、
- もし e.[[ExportName]] が
exportName なら、
- もし exportName が
"default" なら、Assert : このモジュールによってdefaultエクスポートは明示的に定義されていない。null を返す。- 注:
defaultエクスポートはexport * from "mod"宣言では提供できない。
- starResolution を
null とする。 - module.[[StarExportEntries]] の各
ExportEntryレコード e について、Assert : e.[[ModuleRequest]] はnull ではない。- importedModule を
GetImportedModule (module, e.[[ModuleRequest]]) とする。 - resolution を importedModule.ResolveExport(exportName, resolveSet) とする。
- もし resolution が
ambiguous なら、ambiguous を返す。 - もし resolution が
null でなければ、Assert : resolution はResolvedBindingレコード である。- もし starResolution が
null なら、- starResolution を resolution に設定する。
- それ以外の場合、
Assert : 要求された名前を含む*インポートが複数存在する。- もし resolution.[[Module]] と
starResolution.[[Module]] が同じ
モジュールレコード でないなら、ambiguous を返す。 - もし resolution.[[BindingName]] が
starResolution.[[BindingName]] でなく、かつ
resolution.[[BindingName]] または
starResolution.[[BindingName]] が
namespace なら、ambiguous を返す。 - もし resolution.[[BindingName]] が
文字列 であり、starResolution.[[BindingName]] も文字列 であり、かつ両者が異なる場合、ambiguous を返す。
- starResolution を返す。
16.2.1.7.3 循環モジュールレコード抽象メソッドの実装
以下は、
16.2.1.7.3.1 InitializeEnvironment ( )
- module.[[IndirectExportEntries]] の各
ExportEntryレコード e について、Assert : e.[[ExportName]] はnull ではない。- resolution を module.ResolveExport(e.[[ExportName]]) とする。
- もし resolution が
null またはambiguous なら、SyntaxError 例外を投げる。 Assert : resolution はResolvedBindingレコード である。
Assert : module の全ての名前付きエクスポートは解決可能である。- realm を module.[[Realm]] とする。
Assert : realm はundefined ではない。- env を
NewModuleEnvironment (realm.[[GlobalEnv]]) とする。 - module.[[Environment]] を env に設定する。
- module.[[ImportEntries]] の各
ImportEntryレコード in について、- importedModule を
GetImportedModule (module, in.[[ModuleRequest]]) とする。 - もし in.[[ImportName]] が
namespace-object なら、- namespace を
GetModuleNamespace (importedModule) とする。 - ! env.CreateImmutableBinding(in.[[LocalName]],
true ) を実行する。 - ! env.InitializeBinding(in.[[LocalName]], namespace) を実行する。
- namespace を
- それ以外の場合、
- resolution を importedModule.ResolveExport(in.[[ImportName]]) とする。
- もし resolution が
null またはambiguous なら、SyntaxError 例外を投げる。 - もし resolution.[[BindingName]] が
namespace なら、- namespace を
GetModuleNamespace (resolution.[[Module]]) とする。 - !
env.CreateImmutableBinding(in.[[LocalName]],
true ) を実行する。 - ! env.InitializeBinding(in.[[LocalName]], namespace) を実行する。
- namespace を
- それ以外の場合、
CreateImportBinding (env, in.[[LocalName]], resolution.[[Module]], resolution.[[BindingName]]) を実行する。
- importedModule を
- moduleContext を新しい
ECMAScriptコード実行コンテキスト とする。 - moduleContext の Function を
null に設定する。 Assert : module.[[Realm]] はundefined ではない。- moduleContext の
Realm を module.[[Realm]] に設定する。 - moduleContext の ScriptOrModule を module に設定する。
- moduleContext の VariableEnvironment を module.[[Environment]] に設定する。
- moduleContext の LexicalEnvironment を module.[[Environment]] に設定する。
- moduleContext の PrivateEnvironment を
null に設定する。 - module.[[Context]] を moduleContext に設定する。
- moduleContext を
実行コンテキストスタック にプッシュする。moduleContext が実行中の実行コンテキスト となる。 - code を module.[[ECMAScriptCode]] とする。
- varDeclarations を
VarScopedDeclarations (code) とする。 - declaredVarNames を新しい空の
リスト とする。 - varDeclarations の各要素 d について、
BoundNames (d) の各要素 dn について、- もし declaredVarNames に dn が含まれていなければ、
- ! env.CreateMutableBinding(dn,
false ) を実行する。 - ! env.InitializeBinding(dn,
undefined ) を実行する。 - dn を declaredVarNames に追加する。
- ! env.CreateMutableBinding(dn,
- もし declaredVarNames に dn が含まれていなければ、
- lexDeclarations を
LexicallyScopedDeclarations (code) とする。 - privateEnv を
null とする。 - lexDeclarations の各要素 d について、
BoundNames (d) の各要素 dn について、- もし
IsConstantDeclaration (d) がtrue なら、- !
env.CreateImmutableBinding(dn,
true ) を実行する。
- !
env.CreateImmutableBinding(dn,
- それ以外の場合、
- ! env.CreateMutableBinding(dn,
false ) を実行する。
- ! env.CreateMutableBinding(dn,
- もし d が
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration なら、- fo を
InstantiateFunctionObject (d, env, privateEnv) とする。 - ! env.InitializeBinding(dn, fo) を実行する。
- fo を
- もし
- moduleContext を
実行コンテキストスタック から除去する。 unused を返す。
16.2.1.7.3.2 ExecuteModule ( [ capability ] )
- moduleContext を新しい
ECMAScriptコード実行コンテキスト とする。 - moduleContext の Function を
null に設定する。 - moduleContext の
Realm を module.[[Realm]] に設定する。 - moduleContext の ScriptOrModule を module に設定する。
Assert : module はリンク済みで、モジュール環境内の宣言もインスタンス化済みである。- moduleContext の VariableEnvironment を module.[[Environment]] に設定する。
- moduleContext の LexicalEnvironment を module.[[Environment]] に設定する。
実行中の実行コンテキスト をサスペンドする。- もし module.[[HasTLA]] が
false なら、Assert : capability は未指定。- moduleContext を
実行コンテキストスタック にプッシュする。moduleContext が実行中の実行コンテキスト となる。 - result を
Completion (Evaluation (module.[[ECMAScriptCode]])) とする。 - moduleContext をサスペンドし、
実行コンテキストスタック から除去する。 - スタック上のトップにあるコンテキストを
実行中の実行コンテキスト として再開する。 - もし result が
abrupt completion なら、- ? result を返す。
- それ以外の場合、
Assert : capability はPromiseCapabilityレコード である。AsyncBlockStart (capability, module.[[ECMAScriptCode]], moduleContext) を実行する。
unused を返す。
16.2.1.8 合成モジュールレコード
合成モジュールレコードは、仕様によって定義されたモジュールに関する情報を表現するために使用される。そのエクスポートされる名前は生成時に静的に定義されるが、対応する値は
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[ExportNames]] | 文字列の |
モジュールのエクスポート名。このリストには重複が含まれない。 |
| [[EvaluationSteps]] | モジュール評価時に実行する初期化ロジック。 |
16.2.1.8.1 CreateDefaultExportSyntheticModule (defaultExport)
抽象操作 CreateDefaultExportSyntheticModule は、引数 defaultExport（
- realm を
現在の Realm レコード とする。 - setDefaultExport を引数 (module) を受け取り
defaultExport をキャプチャする新しい
抽象クロージャ とし、呼び出し時に以下を実行する：SetSyntheticModuleExport (module,"default" , defaultExport) を実行する。NormalCompletion (unused ) を返す。
- 以下を返す：
合成モジュールレコード { [[Realm]]: realm, [[Environment]]:empty , [[Namespace]]:empty , [[HostDefined]]:undefined , [[ExportNames]]: «"default" », [[EvaluationSteps]]: setDefaultExport }。
16.2.1.8.2 ParseJSONModule ( source )
抽象操作 ParseJSONModule は、引数 source（文字列）を受け取り、
- json を ?
ParseJSON (source) とする。 CreateDefaultExportSyntheticModule (json) を返す。
16.2.1.8.3 SetSyntheticModuleExport ( module, exportName, exportValue )
抽象操作 SetSyntheticModuleExport は、引数 module（
16.2.1.8.4 モジュールレコード抽象メソッドの実装
以下は、
16.2.1.8.4.1 LoadRequestedModules ( )
- !
PromiseResolve (%Promise% ,undefined ) を返す。
16.2.1.8.4.2 GetExportedNames ( )
- module.[[ExportNames]] を返す。
16.2.1.8.4.3 ResolveExport ( exportName )
- もし module.[[ExportNames]] が
exportName を含まなければ、
null を返す。 ResolvedBindingレコード { [[Module]]: module, [[BindingName]]: exportName } を返す。
16.2.1.8.4.4 Link ( )
- realm を module.[[Realm]] とする。
- env を
NewModuleEnvironment (realm.[[GlobalEnv]]) とする。 - module.[[Environment]] を env に設定する。
- module.[[ExportNames]] の各文字列
exportName について、
- ! env.CreateMutableBinding(exportName,
false ) を実行する。 - ! env.InitializeBinding(exportName,
undefined ) を実行する。
- ! env.CreateMutableBinding(exportName,
NormalCompletion (unused ) を返す。
16.2.1.8.4.5 Evaluate ( )
- moduleContext を新しい
ECMAScriptコード実行コンテキスト とする。 - moduleContext の Function を
null に設定する。 - moduleContext の
Realm を module.[[Realm]] に設定する。 - moduleContext の ScriptOrModule を module に設定する。
- moduleContext の VariableEnvironment を module.[[Environment]] に設定する。
- moduleContext の LexicalEnvironment を module.[[Environment]] に設定する。
実行中の実行コンテキスト をサスペンドする。- moduleContext を
実行コンテキストスタック にプッシュする。moduleContext が実行中の実行コンテキスト となる。 - steps を module.[[EvaluationSteps]] とする。
- result を
Completion (steps(module)) とする。 - moduleContext をサスペンドし、
実行コンテキストスタック から除去する。 - スタック上のトップにあるコンテキストを
実行中の実行コンテキスト として再開する。 - pc を !
NewPromiseCapability (%Promise% ) とする。 IfAbruptRejectPromise (result, pc) を実行する。- !
Call (pc.[[Resolve]],undefined , «undefined ») を実行する。 - pc.[[Promise]] を返す。
16.2.1.9 GetImportedModule ( referrer, request )
抽象操作 GetImportedModule は、引数 referrer（
- records を
リスト とし、referrer.[[LoadedModules]] の各LoadedModuleRequestレコード r について、ModuleRequestsEqual (r, request) がtrue であるものを集める。 Assert : records はちょうど 1 要素を持つ。これは、LoadRequestedModules が referrer で正常に完了し、この抽象操作が呼ばれる前であるためである。- record を records の唯一の要素とする。
- record.[[Module]] を返す。
16.2.1.10 HostLoadImportedModule ( referrer, moduleRequest, hostDefined, payload )
referrer が
<button type="button" onclick="import('./foo.mjs')">Click me</button>その時点で
HostLoadImportedModule の実装は、以下の要件に準拠しなければならない：
-
ホスト環境 は、FinishLoadingImportedModule (referrer, moduleRequest, payload, result) を実行しなければならず、result はロード済みモジュールレコード を含む正常完了 またはthrow completion のいずれかである（同期または非同期）。 -
この操作が、2つの (referrer, moduleRequest) ペアで複数回呼ばれ、
- 最初の referrer が2つ目の referrer と同じであり、
ModuleRequestsEqual (最初の moduleRequest, 2つ目の moduleRequest) がtrue である場合、
そして
FinishLoadingImportedModule (referrer, moduleRequest, payload, result) が正常完了 で実行された場合、毎回同じ result で FinishLoadingImportedModule を実行しなければならない。 -
もし moduleRequest.[[Attributes]] に entry があり、entry.[[Key]] が
"type" かつ entry.[[Value]] が"json" の場合、ホスト環境 はFinishLoadingImportedModule (referrer, moduleRequest, payload, result) を実行する際、result はParseJSONModule の呼び出しで返されたCompletion Record またはthrow completion でなければならない。 -
この操作は payload を不透明値として扱い、
FinishLoadingImportedModule へ渡す必要がある。
実際の処理は
上記の文は、type: "json" でインポートされた場合に JSON モジュールをサポートする必要がある（HostLoadImportedModule
が正常完了した場合）が、type: "json" なしでインポートした場合に JSON モジュールをサポートすることを禁じるものではない。
16.2.1.11 FinishLoadingImportedModule ( referrer, moduleRequest, payload, result )
抽象操作 FinishLoadingImportedModule は、引数 referrer（
- もし result が
正常完了 であれば、- もし referrer.[[LoadedModules]] に
LoadedModuleRequestレコード record があり、ModuleRequestsEqual (record, moduleRequest) がtrue なら、 - それ以外の場合、
LoadedModuleRequestレコード { [[Specifier]]: moduleRequest.[[Specifier]], [[Attributes]]: moduleRequest.[[Attributes]], [[Module]]: result.[[Value]] } を referrer.[[LoadedModules]] に追加する。
- もし referrer.[[LoadedModules]] に
- もし payload が
GraphLoadingStateレコード なら、ContinueModuleLoading (payload, result) を実行する。
- それ以外の場合、
ContinueDynamicImport (payload, result) を実行する。
unused を返す。
16.2.1.12 AllImportAttributesSupported ( attributes )
抽象操作 AllImportAttributesSupported は、引数 attributes（
- supported を
HostGetSupportedImportAttributes () とする。 - attributes の各
ImportAttributeレコード attribute について、- もし supported に attribute.[[Key]] が含まれていなければ、
false を返す。
- もし supported に attribute.[[Key]] が含まれていなければ、
true を返す。
16.2.1.12.1 HostGetSupportedImportAttributes ( )
HostGetSupportedImportAttributes の実装は、以下の要件に準拠しなければならない：
HostGetSupportedImportAttributes のデフォルト実装は、新しい空の
16.2.1.13 GetModuleNamespace ( module )
抽象操作 GetModuleNamespace は、引数 module（
Assert : module が循環モジュールレコード の場合、module.[[Status]] はnew またはunlinked でない。- namespace を module.[[Namespace]] とする。
- もし namespace が
empty なら、- exportedNames を module.GetExportedNames() とする。
- unambiguousNames を新しい空の
リスト とする。 - exportedNames の各要素 name について、
- resolution を module.ResolveExport(name) とする。
- もし resolution が
ResolvedBindingレコード であれば、name を unambiguousNames に追加する。
- namespace を
ModuleNamespaceCreate (module, unambiguousNames) に設定する。
- namespace を返す。
GetModuleNamespace は決して例外を投げない。この時点で解決できない名前は単に名前空間から除外される。これらは後で本当のリンクエラーにつながるが、すべてが明示的に要求されていない曖昧な star エクスポートのみの場合は除外される。
16.2.1.14 実行時意味論: Evaluation
undefined を返す。
- result を
Completion (Evaluation (ModuleItemList )) とする。 - もし result が
正常完了 であり、result.[[Value]] がempty なら、undefined を返す。
- ? result を返す。
- sl を ?
Evaluation (ModuleItemList ) とする。 - s を
Completion (Evaluation (ModuleItem )) とする。 - ?
UpdateEmpty (s, sl) を返す。
empty を返す。
16.2.2 インポート
構文
16.2.2.1 静的セマンティクス: 早期エラー
-
ImportDeclaration のBoundNames に重複するエントリが含まれている場合、構文エラーとなる。
-
WithClause のWithClauseToAttributes に、aとbという2つの異なるエントリがあり、a.[[Key]] が b.[[Key]] である場合、構文エラーとなる。
16.2.2.2 静的セマンティクス: ImportEntries
-
新しい空の
リスト を返す。
-
entries1 を
ModuleItemList のImportEntries とする。 -
entries2 を
ModuleItem のImportEntries とする。 -
entries1 と entries2 の
リスト連結 を返す。
-
新しい空の
リスト を返す。
-
module を
ImportDeclaration のModuleRequests の唯一の要素とする。 -
ImportClause のImportEntriesForModule に引数 module を渡して返す。
-
新しい空の
リスト を返す。
16.2.2.3 静的セマンティクス: ImportEntriesForModule
-
entries1 を
ImportedDefaultBinding のImportEntriesForModule （引数 module）とする。 -
entries2 を
NameSpaceImport のImportEntriesForModule （引数 module）とする。 -
entries1 と entries2 の
リスト連結 を返す。
-
entries1 を
ImportedDefaultBinding のImportEntriesForModule （引数 module）とする。 -
entries2 を
NamedImports のImportEntriesForModule （引数 module）とする。 -
entries1 と entries2 の
リスト連結 を返す。
-
localName を
ImportedBinding のBoundNames の唯一の要素とする。 -
defaultEntry を
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:"default" , [[LocalName]]: localName } とする。 - « defaultEntry » を返す。
-
localName を
ImportedBinding のStringValue とする。 -
entry を
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:namespace-object , [[LocalName]]: localName } とする。 - « entry » を返す。
-
新しい空の
リスト を返す。
-
specs1 を
ImportsList のImportEntriesForModule （引数 module）とする。 -
specs2 を
ImportSpecifier のImportEntriesForModule （引数 module）とする。 -
specs1 と specs2 の
リスト連結 を返す。
-
localName を
ImportedBinding のBoundNames の唯一の要素とする。 -
entry を
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: localName, [[LocalName]]: localName } とする。 - « entry » を返す。
-
importName を
ModuleExportName のStringValue とする。 -
localName を
ImportedBinding のStringValue とする。 -
entry を
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName } とする。 - « entry » を返す。
16.2.2.4 静的セマンティクス: WithClauseToAttributes
- 新しい空の
リスト を返す。
- attributes を
WithEntries のWithClauseToAttributes とする。 - attributes の [[Key]]
フィールドの値をUTF-16コード単位値の列として扱い、辞書式順序でソートする。注: このソートは、
ホスト が属性の列挙順に基づいて動作を変更することを禁止する点でのみ観察可能である。 - attributes を返す。
- key を
AttributeKey のPropName とする。 - entry を
ImportAttribute Record { [[Key]]: key, [[Value]]:StringLiteral のSV } とする。 - « entry » を返す。
- key を
AttributeKey のPropName とする。 - entry を
ImportAttribute Record { [[Key]]: key, [[Value]]:StringLiteral のSV } とする。 - rest を
WithEntries のWithClauseToAttributes とする。 - « entry » と rest の
リスト連結 を返す。
16.2.3 エクスポート
構文
16.2.3.1 静的セマンティクス: 早期エラー
-
NamedExports のReferencedBindings にStringLiteral が含まれている場合、構文エラーとなる。 -
NamedExports のReferencedBindings の各IdentifierName n について: n のStringValue がReservedWord である場合、または n のStringValue が"implements" ,"interface" ,"let" ,"package" ,"private" ,"protected" ,"public" ,"static" のいずれかである場合、構文エラーとなる。
上記の規則は、
16.2.3.2 静的セマンティクス: ExportedBindings
ExportedBindingsは、
以下の生成規則ごとに定義される:
-
names1 を
ModuleItemList のExportedBindings とする。 -
names2 を
ModuleItem のExportedBindings とする。 -
names1 と names2 の
リスト連結 を返す。
- 新しい空の
リスト を返す。
- 新しい空の
リスト を返す。
-
NamedExports のExportedBindings を返す。
-
VariableStatement のBoundNames を返す。
-
Declaration のBoundNames を返す。
-
この
ExportDeclaration のBoundNames を返す。
- 新しい空の
リスト を返す。
-
names1 を
ExportsList のExportedBindings とする。 -
names2 を
ExportSpecifier のExportedBindings とする。 -
names1 と names2 の
リスト連結 を返す。
-
ModuleExportName のStringValue を唯一の要素とするリスト を返す。
-
最初の
ModuleExportName のStringValue を唯一の要素とするリスト を返す。
16.2.3.3 静的セマンティクス: ExportedNames
ExportedNamesは、
以下の生成規則ごとに定義される:
-
names1 を
ModuleItemList のExportedNames とする。 -
names2 を
ModuleItem のExportedNames とする。 -
names1 と names2 の
リスト連結 を返す。
-
ExportDeclaration のExportedNames を返す。
- 新しい空の
リスト を返す。
-
ExportFromClause のExportedNames を返す。
- 新しい空の
リスト を返す。
-
ModuleExportName のStringValue を唯一の要素とするリスト を返す。
-
NamedExports のExportedNames を返す。
-
VariableStatement のBoundNames を返す。
-
Declaration のBoundNames を返す。
- «
"default" » を返す。
- 新しい空の
リスト を返す。
-
names1 を
ExportsList のExportedNames とする。 -
names2 を
ExportSpecifier のExportedNames とする。 -
names1 と names2 の
リスト連結 を返す。
-
ModuleExportName のStringValue を唯一の要素とするリスト を返す。
-
2番目の
ModuleExportName のStringValue を唯一の要素とするリスト を返す。
16.2.3.4 静的セマンティクス: ExportEntries
- 新しい空の
リスト を返す。
-
entries1 を
ModuleItemList のExportEntries とする。 -
entries2 を
ModuleItem のExportEntries とする。 -
entries1 と entries2 の
リスト連結 を返す。
- 新しい空の
リスト を返す。
-
module を
ExportDeclaration のModuleRequests の唯一の要素とする。 -
ExportFromClause のExportEntriesForModule に引数 module を渡して返す。
-
NamedExports のExportEntriesForModule に引数null を渡して返す。
- 新しい空の
リスト を entries とする。 -
VariableStatement のBoundNames を names とする。 -
names の各要素 name について、次を行う
-
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name } を entries に追加する。
-
- entries を返す。
- 新しい空の
リスト を entries とする。 -
Declaration のBoundNames を names とする。 -
names の各要素 name について、次を行う
-
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name } を entries に追加する。
-
- entries を返す。
-
HoistableDeclaration のBoundNames を names とする。 - localName を names の唯一の要素とする。
-
リスト の唯一の要素として、新しいExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: localName, [[ExportName]]:"default" } を返す。
-
ClassDeclaration のBoundNames を names とする。 - localName を names の唯一の要素とする。
-
リスト の唯一の要素として、新しいExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: localName, [[ExportName]]:"default" } を返す。
-
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]:"*default*" , [[ExportName]]:"default" } を entry とする。 - « entry » を返す。
16.2.3.5 静的セマンティクス: ExportEntriesForModule
-
entry を
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:all-but-default , [[LocalName]]:null , [[ExportName]]:null } とする。 - « entry » を返す。
-
exportName を
ModuleExportName のStringValue とする。 -
entry を
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:all , [[LocalName]]:null , [[ExportName]]: exportName } とする。 - « entry » を返す。
- 新しい空の
リスト を返す。
-
specs1 を
ExportsList のExportEntriesForModule （引数 module）とする。 -
specs2 を
ExportSpecifier のExportEntriesForModule （引数 module）とする。 -
specs1 と specs2 の
リスト連結 を返す。
-
sourceName を
ModuleExportName のStringValue とする。 - もし module が
null なら、- localName を sourceName とする。
- importName を
null とする。
- それ以外の場合、
- localName を
null とする。 - importName を sourceName とする。
- localName を
-
新しい
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName, [[ExportName]]: sourceName } を唯一の要素とするリスト を返す。
-
sourceName を最初の
ModuleExportName のStringValue とする。 -
exportName を2番目の
ModuleExportName のStringValue とする。 - もし module が
null なら、- localName を sourceName とする。
- importName を
null とする。
- それ以外の場合、
- localName を
null とする。 - importName を sourceName とする。
- localName を
-
新しい
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName, [[ExportName]]: exportName } を唯一の要素とするリスト を返す。
16.2.3.6 静的セマンティクス: ReferencedBindings
- 新しい空の
リスト を返す。
-
names1 を
ExportsList のReferencedBindings とする。 -
names2 を
ExportSpecifier のReferencedBindings とする。 -
names1 と names2 の
リスト連結 を返す。
-
最初の
ModuleExportName のReferencedBindings を返す。
-
IdentifierName を唯一の要素とするリスト を返す。
-
StringLiteral を唯一の要素とするリスト を返す。
16.2.3.7 実行時意味論: 評価
empty を返す。
- ?
Evaluation ofVariableStatement を返す。
- ?
Evaluation ofDeclaration を返す。
- ?
Evaluation ofHoistableDeclaration を返す。
-
value を ?
BindingClassDeclarationEvaluation ofClassDeclaration とする。 -
className を
ClassDeclaration のBoundNames の唯一の要素とする。 -
className が
"*default*" なら、- env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - ?
InitializeBoundName ("*default*" , value, env) を実行する。
- env を
empty を返す。
-
IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue なら、- value を ?
NamedEvaluation ofAssignmentExpression with argument"default" とする。
- value を ?
- それ以外の場合、
- rhs を ?
Evaluation ofAssignmentExpression とする。 - value を ?
GetValue (rhs) とする。
- rhs を ?
- env を
実行中の実行コンテキスト の LexicalEnvironment とする。 - ?
InitializeBoundName ("*default*" , value, env) を実行する。 empty を返す。
17 エラー処理と言語拡張
実装は、関連するECMAScript言語構造が評価される時点でほとんどのエラーを報告しなければならない。早期エラーは、エラーを含むevalが呼び出された時点で報告され、evalコードの評価は行われない。
実装は、本仕様の「静的セマンティクス:早期エラー」サブ句に記載される条件の発生を
実装は、他の種類のエラーを
実装は、以下の場合を除き、すべてのエラーを指定通り報告しなければならない：
-
17.1 で制限されている場合を除き、ホスト や実装はScript 構文、Module 構文、正規表現パターンやフラグ構文を拡張できる。これを許可するため、evalの呼び出し、正規表現リテラルの使用、FunctionやRegExpのコンストラクター の使用など、SyntaxError をスローする可能性があるすべての操作は、スクリプト構文や正規表現パターン・フラグ構文のホスト定義 拡張に遭遇した場合、SyntaxError をスローする代わりにホスト定義 動作を示してもよい。 -
17.1 で制限されている場合を除き、ホスト や実装は、本仕様で記述されているもの以外の型、値、オブジェクト、プロパティ、関数を追加で提供できる。これにより、（グローバルスコープの変数の検索など）エラー（ReferenceError など）をスローする代わりにホスト定義 動作を示すことがある。
17.1 禁止される拡張
実装は、以下の方法で本仕様を拡張してはならない：
-
関数オブジェクト を、構築子 で構文的に定義し、厳格モードコード 内で生成する場合、"caller" や"arguments" という名前の独自プロパティを作成してはならない。これらの独自プロパティは、関数オブジェクト がArrowFunction 、MethodDefinition 、GeneratorDeclaration 、GeneratorExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、ClassDeclaration 、ClassExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncArrowFunction で定義されている場合にも、定義が厳格モードコード 内かどうかに関わらず作成してはならない。組み込み関数、Functionコンストラクター で生成された厳格関数 、Generatorコンストラクター で生成されたジェネレーター関数、AsyncFunctionコンストラクター で生成された非同期関数、およびbindメソッドで生成された関数も、これらの独自プロパティを持っていてはならない。 -
実装が
関数オブジェクト に"caller" という名前の独自プロパティを拡張した場合、そのプロパティの値（[[Get]]や[[GetOwnProperty]]で観察される値）は厳格関数 オブジェクトであってはならない。もしそのプロパティがアクセサプロパティ である場合、[[Get]]属性の関数は呼び出された際に厳格関数 を返してはならない。 -
マップ済み・未マップいずれのargumentsオブジェクトも、
"caller" という名前の独自プロパティを持っていてはならない。 -
ECMA-402で仕様化された
toLocaleStringなどの組み込みメソッドの挙動は、ECMA-402で指定されている場合を除いて拡張してはならない。 -
22.2.1 およびB.1.2 で定義されたRegExpパターン文法は、[UnicodeMode]文法パラメータが存在する場合、ソース文字A-Zやa-zをIdentityEscape として認識するように拡張してはならない。[+UnicodeMode] -
構文文法を拡張して、
BindingIdentifier 非終端記号によってマッチされたソーステキストの直後に:トークンが現れることを許容してはならない。 -
厳格モードコード を処理する際、12.9.3.1 の早期エラー 規則を緩和してはならない。 -
TemplateEscapeSequence を、12.9.4 で定義されるLegacyOctalEscapeSequence やNonOctalDecimalEscapeSequence を含むように拡張してはならない。 -
厳格モードコード を処理する際、B.3.1 、B.3.2 、B.3.3 、B.3.5 で定義される拡張をサポートしてはならない。 -
Module の目標記号 をパースする際、B.1.1 で定義される字句文法の拡張をサポートしてはならない。 -
ImportCall を拡張してはならない。
18 ECMAScript 標準組み込みオブジェクト
ECMAScriptの
特に指定がない限り、関数として呼び出し可能な組み込みオブジェクトは、
多くの組み込みオブジェクトは関数であり、引数を伴って呼び出すことができる。その中にはnew演算子とともに使うことを意図した関数もある。本仕様では、各組み込み関数について必要な引数と、そのnew式で生成される特定のインスタンスのプロパティも記載する。
特に指定がない限り、ある関数の説明で要求されている引数より少ない引数が組み込み関数または
特に指定がない限り、関数の説明で許可されているより多くの引数が組み込み関数や
組み込み関数に追加機能を加える場合は、既存の関数に新たなパラメータを追加するのではなく、新しい関数を追加することが推奨される。
特に指定がない限り、すべての組み込み関数および組み込みFunction.prototypeの初期値、
特に指定がない限り、すべての組み込みプロトタイプオブジェクトは、Object.prototypeの初期値、
本仕様でアルゴリズムステップによって組み込み
組み込み
組み込み
本仕様で定義される各組み込み関数は、
全ての組み込み
例えば、
特に指定がない限り、組み込み
全ての組み込み
本仕様で
特に指定がない限り、組み込み
19 グローバルオブジェクト
グローバルオブジェクト：
実行コンテキスト に入る前に作成される。- [[Construct]]内部メソッドを持たないため、
new演算子とともにコンストラクター として使用することはできない。 - [[Call]]内部メソッドを持たないため、関数として呼び出すことはできない。
- [[Prototype]]内部スロットの値は
ホスト定義 である。 - 本仕様で定義されているプロパティに加え、
ホスト定義 プロパティを持つ場合がある。この中にはグローバルオブジェクト自身を値として持つプロパティも含まれる可能性がある。
19.1 グローバルオブジェクトの値プロパティ
19.1.1 globalThis
このプロパティの属性は { [[Writable]]:
19.1.2 Infinity
Infinity の値は
19.1.3 NaN
NaN の値は
19.1.4 undefined
undefined の値は
19.2 グローバルオブジェクトの関数プロパティ
19.2.1 eval ( x )
この関数は %eval% 既定オブジェクトである。
呼び出されたとき、次の手順を実行する：
- ?
PerformEval (x,false ,false ) を返す。
19.2.1.1 PerformEval ( x, strictCaller, direct )
抽象演算PerformEvalは、引数x（
アサート ：directがfalse の場合、strictCallerもfalse である。- xが
文字列でない 場合、xを返す。 - evalRealmを
現在のRealm Record とする。 - 注：
直接eval の場合、evalRealmはevalの呼び出し元と関数自身のrealm の両方となる。 - ?
HostEnsureCanCompileStrings (evalRealm, « », x, direct) を実行する。 - inFunctionを
false とする。 - inMethodを
false とする。 - inDerivedConstructorを
false とする。 - inClassFieldInitializerを
false とする。 - directが
true の場合、- thisEnvRecを
GetThisEnvironment ()とする。 - thisEnvRecが
関数環境レコード である場合、- FをthisEnvRec.[[FunctionObject]]とする。
- inFunctionを
true にする。 - inMethodをthisEnvRec.HasSuperBinding()にする。
- F.[[ConstructorKind]]が
derived の場合、inDerivedConstructorをtrue にする。 - classFieldInitializerNameをF.[[ClassFieldInitializerName]]とする。
- classFieldInitializerNameが
empty でない場合、inClassFieldInitializerをtrue にする。
- thisEnvRecを
- 以下のサブステップを、実装定義順序（実装によって解析とエラー検出が割り込まれる可能性あり）で実行する：
- scriptを
ParseText (x,Script )とする。 - scriptが
エラーのリスト の場合、SyntaxError 例外を投げる。 - scriptの
Contains ScriptBody がfalse の場合、undefined を返す。 - bodyをscriptの
ScriptBody とする。 - inFunctionが
false かつbodyのContains NewTarget がtrue の場合、SyntaxError 例外を投げる。 - inMethodが
false かつbodyのContains SuperProperty がtrue の場合、SyntaxError 例外を投げる。 - inDerivedConstructorが
false かつbodyのContains SuperCall がtrue の場合、SyntaxError 例外を投げる。 - inClassFieldInitializerが
true かつContainsArguments of bodyがtrue の場合、SyntaxError 例外を投げる。
- scriptを
- strictCallerが
true の場合、strictEvalをtrue にする。 - それ以外の場合、strictEvalを
ScriptIsStrict of scriptにする。 - runningContextを
実行中の実行コンテキスト とする。 - 注：directが
true の場合、runningContextは直接eval を実行した実行コンテキスト となる。directがfalse の場合、runningContextはeval関数の呼び出しの実行コンテキスト となる。 - directが
true の場合、- lexEnvを
NewDeclarativeEnvironment (runningContextのLexicalEnvironment)とする。 - varEnvをrunningContextのVariableEnvironmentとする。
- privateEnvをrunningContextのPrivateEnvironmentとする。
- lexEnvを
- それ以外の場合、
- lexEnvを
NewDeclarativeEnvironment (evalRealm.[[GlobalEnv]])とする。 - varEnvをevalRealm.[[GlobalEnv]]とする。
- privateEnvを
null とする。
- lexEnvを
- strictEvalが
true の場合、varEnvをlexEnvに設定する。 - runningContextがまだサスペンドされていなければ、runningContextをサスペンドする。
- evalContextを新しい
ECMAScriptコード実行コンテキスト とする。 - evalContextのFunctionを
null に設定する。 - evalContextの
Realm をevalRealmに設定する。 - evalContextのScriptOrModuleをrunningContextのScriptOrModuleに設定する。
- evalContextのVariableEnvironmentをvarEnvに設定する。
- evalContextのLexicalEnvironmentをlexEnvに設定する。
- evalContextのPrivateEnvironmentをprivateEnvに設定する。
- evalContextを
実行コンテキストスタック にプッシュする。evalContextが新しい実行中の実行コンテキスト となる。 - resultを
Completion (EvalDeclarationInstantiation (body, varEnv, lexEnv, privateEnv, strictEval))とする。 - resultが
正常完了 の場合、- resultを
Completion (Evaluation of body)に設定する。
- resultを
- resultが
正常完了 かつresult.[[Value]]がempty の場合、- resultを
NormalCompletion (undefined )に設定する。
- resultを
- evalContextをサスペンドし、
実行コンテキストスタック から取り除く。 - 現在スタックのトップにあるコンテキストを
実行中の実行コンテキスト として再開する。 - ? resultを返す。
evalコードは、呼び出し元のコンテキストまたはevalコードがlet、const、class宣言によるバインディングは常に新しいLexicalEnvironmentに作成される。
19.2.1.2 HostEnsureCanCompileStrings ( calleeRealm, parameterStrings, bodyString, direct )
parameterStringsは、関数eval呼び出しに渡される文字列を表す。directは評価が
HostEnsureCanCompileStringsのデフォルト実装は
19.2.1.3 EvalDeclarationInstantiation ( body, varEnv, lexEnv, privateEnv, strict )
抽象演算EvalDeclarationInstantiationは、引数body（
- varNames を body の
VarDeclaredNames とする。 - varDeclarations を body の
VarScopedDeclarations とする。 - strict が
false なら、- varEnv が
Global Environment Record である場合、- varNames の各要素 name について、
HasLexicalDeclaration (varEnv, name) がtrue なら、SyntaxError 例外を投げる。- 注:
evalはグローバルなレキシカル宣言に隠蔽されるグローバル var 宣言を作成しない。
- varNames の各要素 name について、
- thisEnv を lexEnv とする。
アサート : 以下のループは必ず終了する。- 繰り返し、thisEnv と varEnv が同じ
Environment Record でない間、- thisEnv が
オブジェクトでない Environment Record である場合、 - thisEnv を thisEnv.[[OuterEnv]] に設定する。
- thisEnv が
- varEnv が
- privateIdentifiers を新しい空の
List とする。 - pointer を privateEnv とする。
- pointer が
null でない間、繰り返し、- pointer.[[Names]] の各
Private Name binding について、- privateIdentifiers が binding.[[Description]] を含まない場合、binding.[[Description]] を privateIdentifiers に追加する。
- pointer を pointer.[[OuterPrivateEnvironment]] に設定する。
- pointer.[[Names]] の各
AllPrivateIdentifiersValid of body with argument privateIdentifiers がfalse なら、SyntaxError 例外を投げる。- functionsToInitialize を新しい空の
List とする。 - declaredFunctionNames を新しい空の
List とする。 - varDeclarations の各要素 d について、逆順
List で、- d が
VariableDeclaration 、ForBinding 、またはBindingIdentifier のいずれでもない場合、アサート : d はFunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである。- 注: 同じ名前の関数宣言が複数ある場合、最後の宣言が使用される。
- fn を d の
BoundNames の唯一の要素とする。 - declaredFunctionNames が fn を含まない場合、
- varEnv が
Global Environment Record である場合、- fnDefinable を ?
CanDeclareGlobalFunction (varEnv, fn) とする。 - fnDefinable が
false なら、TypeError 例外を投げる。
- fnDefinable を ?
- fn を declaredFunctionNames に追加する。
- d を functionsToInitialize の先頭に挿入する。
- varEnv が
- d が
- declaredVarNames を新しい空の
List とする。 - varDeclarations の各要素 d について、
- d が
VariableDeclaration 、ForBinding 、またはBindingIdentifier のいずれかである場合、- d の
BoundNames の各 String vn について、- declaredFunctionNames が vn を含まない場合、
- varEnv が
Global Environment Record である場合、- vnDefinable を ?
CanDeclareGlobalVar (varEnv, vn) とする。 - vnDefinable が
false なら、TypeError 例外を投げる。
- vnDefinable を ?
- declaredVarNames が vn を含まない場合、
- vn を declaredVarNames に追加する。
- varEnv が
- declaredFunctionNames が vn を含まない場合、
- d の
- d が
- 注: 付録
B.3.2.3 でこの位置に追加のステップが追加される。 - 注:
このアルゴリズムステップの後は、varEnv が
Global Environment Record かつglobal object がProxy exotic object でない限り、異常終了は発生しない。 - lexDeclarations を body の
LexicallyScopedDeclarations とする。 - lexDeclarations の各要素 d について、
- 注: レキシカル宣言された名前はここでインスタンス化されるが初期化はされない。
- d の
BoundNames の各要素 dn について、IsConstantDeclaration of d がtrue なら、- ? lexEnv.CreateImmutableBinding(dn,
true ) を実行する。
- ? lexEnv.CreateImmutableBinding(dn,
- それ以外の場合、
- ? lexEnv.CreateMutableBinding(dn,
false ) を実行する。
- ? lexEnv.CreateMutableBinding(dn,
- functionsToInitialize の各
構文ノード f について、- fn を f の
BoundNames の唯一の要素とする。 - fo を f の
InstantiateFunctionObject with arguments lexEnv および privateEnv とする。 - varEnv が
Global Environment Record である場合、- ?
CreateGlobalFunctionBinding (varEnv, fn, fo,true ) を実行する。
- ?
- それ以外の場合、
- bindingExists を ! varEnv.HasBinding(fn) とする。
- bindingExists が
false なら、- 注: 以下の呼び出しは
abrupt completion を返さない（ステップ14 で検証済み）。 - ! varEnv.CreateMutableBinding(fn,
true ) を実行する。 - ! varEnv.InitializeBinding(fn, fo) を実行する。
- 注: 以下の呼び出しは
- それ以外の場合、
- ! varEnv.SetMutableBinding(fn,
fo,
false ) を実行する。
- ! varEnv.SetMutableBinding(fn,
fo,
- fn を f の
- declaredVarNames の各 String vn について、
- varEnv が
Global Environment Record である場合、- ?
CreateGlobalVarBinding (varEnv, vn,true ) を実行する。
- ?
- それ以外の場合、
- bindingExists を ! varEnv.HasBinding(vn) とする。
- bindingExists が
false なら、- 注: 以下の呼び出しは
abrupt completion を返さない（ステップ14 で検証済み）。 - ! varEnv.CreateMutableBinding(vn,
true ) を実行する。 - ! varEnv.InitializeBinding(vn,
undefined ) を実行する。
- 注: 以下の呼び出しは
- varEnv が
unused を返す。
このアルゴリズムの別バージョンは
19.2.2 isFinite ( number )
この関数は %isFinite% 既定オブジェクトである。
呼び出されたとき、次の手順を実行する：
19.2.3 isNaN ( number )
この関数は %isNaN% 既定オブジェクトである。
呼び出されたとき、次の手順を実行する：
- num を ?
ToNumber (number) とする。 - num が
NaN なら、true を返す。 - それ以外の場合、
false を返す。
ECMAScriptコードで値 X が X !== X という式である。その結果は、X が
19.2.4 parseFloat ( string )
この関数は、string 引数の内容を10進リテラルとして解釈した結果の Number 値を生成する。
これは %parseFloat% 既定オブジェクトである。
呼び出されたとき、次の手順を実行する：
- inputString を ?
ToString (string) とする。 - trimmedString を !
TrimString (inputString,start ) とする。 - trimmed を
StringToCodePoints (trimmedString) とする。 - trimmedPrefix を trimmed のうち
StrDecimalLiteral の構文を満たす最長の接頭辞（trimmed そのものである場合もある）とする。そのような接頭辞がなければNaN を返す。 - parsedNumber を
ParseText (trimmedPrefix,StrDecimalLiteral ) とする。 アサート : parsedNumber は構文ノード である。- parsedNumber の
StringNumericValue を返す。
この関数は string の先頭部分のみを Number 値として解釈する場合がある。10進リテラルの表記として解釈できないコードユニットは無視され、無視されたことが通知されることはない。
19.2.5 parseInt ( string, radix )
この関数は、指定された radix に従って string の内容を解釈した結果の
これは %parseInt% 既定オブジェクトである。
呼び出されたとき、次の手順を実行する：
- inputString を ?
ToString (string) とする。 - S を !
TrimString (inputString,start ) とする。 - sign を 1 とする。
- S が空でなく、最初のコードユニットが 0x002D（HYPHEN-MINUS）の場合、sign を -1 に設定する。
- S が空でなく、最初のコードユニットが 0x002B（PLUS SIGN）または 0x002D（HYPHEN-MINUS）の場合、S
をインデックス 1 からの
部分文字列 に設定する。 - R を
ℝ (?ToInt32 (radix)) とする。 - stripPrefix を
true とする。 - R ≠ 0 の場合、
- R < 2 または R > 36 の場合、
NaN を返す。 - R ≠ 16 の場合、stripPrefix を
false に設定する。
- R < 2 または R > 36 の場合、
- それ以外の場合、
- R を 10 に設定する。
- stripPrefix が
true の場合、- S の長さが 2 以上で、最初の2コードユニットが
"0x" または"0X" の場合、- S をインデックス2からの
部分文字列 に設定する。 - R を 16 に設定する。
- S をインデックス2からの
- S の長さが 2 以上で、最初の2コードユニットが
- S に radix-R の数字でないコードユニットが含まれる場合、end を S 内の最初のそのコードユニットのインデックスとし、そうでなければ end を S の長さとする。
- Z を S の 0 から end までの
部分文字列 に設定する。 - Z が空の場合、
NaN を返す。 - mathInt を Z が radix-R 表記で表す
整数 値とする（10進なら20桁を超えた桁は0にしてもよい、2/4/8/10/16/32以外の基数なら実装依存の近似整数でもよい）。 - mathInt = 0 の場合、
- sign = -1 なら、
-0 𝔽 を返す。 +0 𝔽 を返す。
- sign = -1 なら、
𝔽 (sign × mathInt) を返す。
この関数は string の先頭部分のみを
19.2.6 URI処理関数
Uniform Resource
Identifier（URI）は、リソース（例：ウェブページやファイル）や、それらにアクセスするための転送プロトコル（例：HTTPやFTP）を識別する文字列である。ECMAScript言語自体はURIを利用するためのサポートを提供していないが、この節で説明されるURIのエンコードおよびデコード関数は提供されている。encodeURIおよびdecodeURIは、完全なURIに対して動作することを意図しており、予約文字が特別な意味（区切り文字など）を持つことを想定し、エンコードしない。encodeURIComponentおよびdecodeURIComponentは、URIの個々のコンポーネントに対して動作することを意図しており、予約文字がテキストを表すものとみなし、完全なURIの一部となる場合に特別な意味を持たせないためにエンコードする必要があると考える。
予約文字のセットはRFC 2396に基づいており、より新しいRFC 3986で導入された変更は反映されていない。
多くのECMAScript実装ではウェブページを操作するための追加の関数やメソッドが提供されているが、これらの関数は本標準の範囲外である。
19.2.6.1 decodeURI ( encodedURI )
この関数は、新しいURIバージョンを計算し、encodeURI関数によって導入される可能性があるエスケープシーケンスやUTF-8エンコーディングを、それが表すコードポイントのUTF-16エンコーディングに置き換える。encodeURIによって導入される可能性がないエスケープシーケンスは置換されない。
これは %decodeURI% 既定オブジェクトである。
呼び出されたとき、次の手順を実行する：
19.2.6.2 decodeURIComponent ( encodedURIComponent )
この関数は、新しいURIバージョンを計算し、encodeURIComponent関数によって導入される可能性があるエスケープシーケンスやUTF-8エンコーディングを、それが表すコードポイントのUTF-16エンコーディングに置き換える。
これは %decodeURIComponent% 既定オブジェクトである。
呼び出されたとき、次の手順を実行する：
19.2.6.3 encodeURI ( uri )
この関数は、UTF-16エンコード（
これは %encodeURI% 既定オブジェクトである。
呼び出されたとき、次の手順を実行する：
19.2.6.4 encodeURIComponent ( uriComponent )
この関数は、UTF-16エンコード（
これは %encodeURIComponent% 既定オブジェクトである。
呼び出されたとき、次の手順を実行する：
19.2.6.5 Encode ( string, extraUnescaped )
抽象演算Encodeは、引数string（文字列）とextraUnescaped（文字列）を受け取り、
- len を string の長さとする。
- R を空文字列とする。
- alwaysUnescaped を
文字列連結 でASCII単語文字 と"-.!~*'()" を連結したものとする。 - unescapedSet を
文字列連結 でalwaysUnescapedとextraUnescapedを連結したものとする。 - k を 0 とする。
- k < len の間、繰り返し、
- C を string のインデックスkのコードユニットとする。
- unescapedSet が C を含む場合、
- k を k + 1 にする。
- R を
文字列連結 でRとCを連結したものにする。
- それ以外の場合、
- cp を
CodePointAt (string, k) とする。 - cp.[[IsUnpairedSurrogate]] が
true の場合、URIError 例外を投げる。 - k を k + cp.[[CodeUnitCount]] にする。
- Octets を
List でcp.[[CodePoint]]にUTF-8変換を適用して得られるオクテットの並びとする。 - Octets の各要素 octet について、
- cp を
- R を返す。
パーセントエンコーディングは個々のオクテットを表すため、1つのコードポイントが複数の連続するエスケープシーケンス（それぞれの8ビットUTF-8コードユニットごと）で表現される場合がある。
19.2.6.6 Decode ( string, preserveEscapeSet )
抽象演算Decodeは、引数string（文字列）とpreserveEscapeSet（文字列）を受け取り、
- len を string の長さとする。
- R を空文字列とする。
- k を 0 とする。
- k < len の間、繰り返し、
- C を string のインデックスkのコードユニットとする。
- S を C とする。
- C がコードユニット0x0025（パーセント記号）の場合、
- k + 3 > len の場合、
URIError 例外を投げる。 - escape を
部分文字列 でstringのkからk+3までとする。 - B を
ParseHexOctet (string, k+1) とする。 - B が
整数 でない場合、URIError 例外を投げる。 - k を k + 2 にする。
- n を B の先頭の1ビットの数とする。
- n = 0 の場合、
- asciiChar を数値がBのコードユニットとする。
- preserveEscapeSet が asciiChar を含む場合 S を escape に、そうでなければ S を asciiChar にする。
- それ以外の場合、
- n = 1 または n > 4
の場合、
URIError 例外を投げる。 - Octets を « B » とする。
- j を 1 とする。
- j < n の間、繰り返し、
- k を k + 1 にする。
- k + 3 > len
の場合、
URIError 例外を投げる。 - string
のインデックスkのコードユニットが0x0025（パーセント記号）でない場合、
URIError 例外を投げる。 - continuationByte を
ParseHexOctet (string, k+1) とする。 - continuationByte が
整数 でない場合、URIError 例外を投げる。 - Octets に continuationByte を追加する。
- k を k + 2 にする。
- j を j + 1 にする。
アサート : Octets の長さは n である。- Octets
が有効なUTF-8エンコーディングのUnicodeコードポイントを含まない場合、
URIError 例外を投げる。 - V をUTF-8変換を適用し、オクテットのリストを21ビット値にしたコードポイントとする。
- S を
UTF16EncodeCodePoint (V) にする。
- n = 1 または n > 4
の場合、
- k + 3 > len の場合、
- R を
文字列連結 でRとSを連結したものにする。 - k を k + 1 にする。
- R を返す。
RFC 3629では無効なUTF-8オクテット列のデコードを禁止している。例えば、無効なシーケンス0xC0
0x80はコードユニット0x0000にデコードしてはならない。Decodeアルゴリズムの実装は、このような無効なシーケンスに遭遇した場合
19.2.6.7 ParseHexOctet ( string, position )
抽象演算ParseHexOctetは、引数string（文字列）とposition（非負の
19.3 グローバルオブジェクトのコンストラクタプロパティ
19.3.1 AggregateError ( . . . )
19.3.2 Array ( . . . )
19.3.3 ArrayBuffer ( . . . )
19.3.4 BigInt ( . . . )
19.3.5 BigInt64Array ( . . . )
19.3.6 BigUint64Array ( . . . )
19.3.7 Boolean ( . . . )
19.3.8 DataView ( . . . )
19.3.9 Date ( . . . )
19.3.10 Error ( . . . )
19.3.11 EvalError ( . . . )
19.3.12 FinalizationRegistry ( . . . )
19.3.13 Float16Array ( . . . )
19.3.14 Float32Array ( . . . )
19.3.15 Float64Array ( . . . )
19.3.16 Function ( . . . )
19.3.17 Int8Array ( . . . )
19.3.18 Int16Array ( . . . )
19.3.19 Int32Array ( . . . )
19.3.20 Iterator ( . . . )
19.3.21 Map ( . . . )
19.3.22 Number ( . . . )
19.3.23 Object ( . . . )
19.3.24 Promise ( . . . )
19.3.25 Proxy ( . . . )
19.3.26 RangeError ( . . . )
19.3.27 ReferenceError ( . . . )
19.3.28 RegExp ( . . . )
19.3.29 Set ( . . . )
19.3.30 SharedArrayBuffer ( . . . )
19.3.31 String ( . . . )
19.3.32 Symbol ( . . . )
19.3.33 SyntaxError ( . . . )
19.3.34 TypeError ( . . . )
19.3.35 Uint8Array ( . . . )
19.3.36 Uint8ClampedArray ( . . . )
19.3.37 Uint16Array ( . . . )
19.3.38 Uint32Array ( . . . )
19.3.39 URIError ( . . . )
19.3.40 WeakMap ( . . . )
19.3.41 WeakRef ( . . . )
19.3.42 WeakSet ( . . . )
19.4 グローバルオブジェクトのその他のプロパティ
19.4.1 Atomics
19.4.2 JSON
19.4.3 Math
19.4.4 Reflect
20 基本オブジェクト
20.1 Object オブジェクト
20.1.1 Object コンストラクター
Object
- %Object% である。
"Object" プロパティの初期値であり、グローバルオブジェクト のプロパティである。通常オブジェクト をコンストラクター として呼び出されたときに作成する。- 関数として呼び出された場合は型変換を行うが、
コンストラクター として呼び出された場合とは異なる。 - クラス定義の
extends節の値として使用できる場合がある。
20.1.1.1 Object ( [ value ] )
この関数は呼び出されたとき、以下の手順を実行する：
- NewTarget が
undefined でもアクティブ関数オブジェクト でもない場合、- ?
OrdinaryCreateFromConstructor (NewTarget,"%Object.prototype%" ) を返す。
- ?
- value が
undefined またはnull の場合、OrdinaryObjectCreate (%Object.prototype% ) を返す。 - !
ToObject (value) を返す。
20.1.2 Object コンストラクターのプロパティ
Object
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% である。 "length" プロパティを持ち、その値は1 𝔽 である。- 以下の追加プロパティを持つ：
20.1.2.1 Object.assign ( target, ...sources )
この関数は、1つ以上のソースオブジェクトから target オブジェクトへ、すべての列挙可能な自身のプロパティの値をコピーする。
呼び出されたとき、以下の手順を実行する：
- to を ?
ToObject (target) とする。 - 引数が1つだけの場合、to を返す。
- sources の各要素 nextSource について、
- nextSource が
undefined でもnull でもない場合、
- nextSource が
- to を返す。
この関数の
20.1.2.2 Object.create ( O, Properties )
この関数は、指定されたプロトタイプを持つ新しいオブジェクトを作成する。
呼び出されたとき、以下の手順を実行する：
- O が
オブジェクトでない かつ O がnull でない場合、TypeError 例外を投げる。 - obj を
OrdinaryObjectCreate (O) とする。 - Properties が
undefined でない場合、- ?
ObjectDefineProperties (obj, Properties) を返す。
- ?
- obj を返す。
20.1.2.3 Object.defineProperties ( O, Properties )
この関数は、オブジェクトの自身のプロパティの追加および既存プロパティの属性更新を行う。
呼び出されたとき、以下の手順を実行する：
- O が
オブジェクトでない 場合、TypeError 例外を投げる。 - ?
ObjectDefineProperties (O, Properties) を返す。
20.1.2.3.1 ObjectDefineProperties ( O, Properties )
抽象演算ObjectDefinePropertiesは、引数O（オブジェクト）とProperties（
- props を ?
ToObject (Properties) とする。 - keys を ? props.[[OwnPropertyKeys]]() とする。
- descriptors を新しい空の
List とする。 - keys の各要素 nextKey について、
- propDesc を ? props.[[GetOwnProperty]](nextKey) とする。
- propDesc が
undefined でなく、かつ propDesc.[[Enumerable]] がtrue の場合、- descObj を ?
Get (props, nextKey) とする。 - desc を ?
ToPropertyDescriptor (descObj) とする。 Record { [[Key]]: nextKey, [[Descriptor]]: desc } を descriptors に追加する。
- descObj を ?
- descriptors の各要素 property について、
- ?
DefinePropertyOrThrow (O, property.[[Key]], property.[[Descriptor]]) を実行する。
- ?
- O を返す。
20.1.2.4 Object.defineProperty ( O, P, Attributes )
この関数は、オブジェクトの自身のプロパティの追加および既存プロパティの属性更新を行う。
呼び出されたとき、以下の手順を実行する：
- O が
オブジェクトでない 場合、TypeError 例外を投げる。 - key を ?
ToPropertyKey (P) とする。 - desc を ?
ToPropertyDescriptor (Attributes) とする。 - ?
DefinePropertyOrThrow (O, key, desc) を実行する。 - O を返す。
20.1.2.5 Object.entries ( O )
この関数は呼び出されたとき、以下の手順を実行する：
- obj を ?
ToObject (O) とする。 - entryList を ?
EnumerableOwnProperties (obj,key+value ) とする。 CreateArrayFromList (entryList) を返す。
20.1.2.6 Object.freeze ( O )
この関数は呼び出されたとき、以下の手順を実行する：
- O が
オブジェクトでない 場合、O を返す。 - status を ?
SetIntegrityLevel (O,frozen ) とする。 - status が
false の場合、TypeError 例外を投げる。 - O を返す。
20.1.2.7 Object.fromEntries ( iterable )
この関数は呼び出されたとき、以下の手順を実行する：
- ?
RequireObjectCoercible (iterable) を実行する。 - obj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 アサート : obj は自身のプロパティを持たず拡張可能な通常オブジェクト である。- closure を、引数 (key, value) を受け obj
をキャプチャし、呼び出された時に以下を実行する新しい
抽象クロージャ とする：- propertyKey を ?
ToPropertyKey (key) とする。 - !
CreateDataPropertyOrThrow (obj, propertyKey, value) を実行する。 NormalCompletion (undefined ) を返す。
- propertyKey を ?
- adder を
CreateBuiltinFunction (closure, 2,"" , « ») とする。 - ?
AddEntriesFromIterable (obj, iterable, adder) を返す。
20.1.2.8 Object.getOwnPropertyDescriptor ( O, P )
この関数は呼び出されたとき、以下の手順を実行する：
- obj を ?
ToObject (O) とする。 - key を ?
ToPropertyKey (P) とする。 - desc を ? obj.[[GetOwnProperty]](key) とする。
FromPropertyDescriptor (desc) を返す。
20.1.2.9 Object.getOwnPropertyDescriptors ( O )
この関数は呼び出されたとき、以下の手順を実行する：
- obj を ?
ToObject (O) とする。 - ownKeys を ? obj.[[OwnPropertyKeys]]() とする。
- descriptors を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - ownKeys の各要素 key について、
- desc を ? obj.[[GetOwnProperty]](key) とする。
- descriptor を
FromPropertyDescriptor (desc) とする。 - descriptor が
undefined でない場合、!CreateDataPropertyOrThrow (descriptors, key, descriptor) を実行する。
- descriptors を返す。
20.1.2.10 Object.getOwnPropertyNames ( O )
この関数は呼び出されたとき、以下の手順を実行する：
CreateArrayFromList (?GetOwnPropertyKeys (O,string )) を返す。
20.1.2.11 Object.getOwnPropertySymbols ( O )
この関数は呼び出されたとき、以下の手順を実行する：
CreateArrayFromList (?GetOwnPropertyKeys (O,symbol )) を返す。
20.1.2.11.1 GetOwnPropertyKeys ( O, type )
抽象演算GetOwnPropertyKeysは、引数O（
20.1.2.12 Object.getPrototypeOf ( O )
この関数は呼び出されたとき、以下の手順を実行する：
- obj を ?
ToObject (O) とする。 - ? obj.[[GetPrototypeOf]]() を返す。
20.1.2.13 Object.groupBy ( items, callback )
callbackは2つの引数を受け取る関数であることが推奨される。groupByはitemsの各要素に対して昇順でcallbackを呼び出し、新しいオブジェクトを構築する。callbackの返り値はすべて
callbackは、要素の値と要素のインデックスという2つの引数で呼び出される。
groupByの返り値は
この関数は呼び出されたとき、以下の手順を実行する：
- groups を ?
GroupBy (items, callback,property ) とする。 - obj を
OrdinaryObjectCreate (null ) とする。 - groups の各
Record { [[Key]], [[Elements]] } g について、- elements を
CreateArrayFromList (g.[[Elements]]) とする。 - !
CreateDataPropertyOrThrow (obj, g.[[Key]], elements) を実行する。
- elements を
- obj を返す。
20.1.2.14 Object.hasOwn ( O, P )
この関数は呼び出されたとき、以下の手順を実行する：
- obj を ?
ToObject (O) とする。 - key を ?
ToPropertyKey (P) とする。 - ?
HasOwnProperty (obj, key) を返す。
20.1.2.15 Object.is ( value1, value2 )
この関数は呼び出されたとき、以下の手順を実行する：
SameValue (value1, value2) を返す。
20.1.2.16 Object.isExtensible ( O )
この関数は呼び出されたとき、以下の手順を実行する：
- O が
オブジェクトでない 場合、false を返す。 - ?
IsExtensible (O) を返す。
20.1.2.17 Object.isFrozen ( O )
この関数は呼び出されたとき、以下の手順を実行する：
- O が
オブジェクトでない 場合、true を返す。 - ?
TestIntegrityLevel (O,frozen ) を返す。
20.1.2.18 Object.isSealed ( O )
この関数は呼び出されたとき、以下の手順を実行する：
- O が
オブジェクトでない 場合、true を返す。 - ?
TestIntegrityLevel (O,sealed ) を返す。
20.1.2.19 Object.keys ( O )
この関数は呼び出されたとき、以下の手順を実行する：
- obj を ?
ToObject (O) とする。 - keyList を ?
EnumerableOwnProperties (obj,key ) とする。 CreateArrayFromList (keyList) を返す。
20.1.2.20 Object.preventExtensions ( O )
この関数は呼び出されたとき、以下の手順を実行する：
- O が
オブジェクトでない 場合、O を返す。 - status を ? O.[[PreventExtensions]]() とする。
- status が
false の場合、TypeError 例外を投げる。 - O を返す。
20.1.2.21 Object.prototype
Object.prototype の初期値は
このプロパティの属性は { [[Writable]]:
20.1.2.22 Object.seal ( O )
この関数は呼び出されたとき、以下の手順を実行する：
- O が
オブジェクトでない 場合、O を返す。 - status を ?
SetIntegrityLevel (O,sealed ) とする。 - status が
false の場合、TypeError 例外を投げる。 - O を返す。
20.1.2.23 Object.setPrototypeOf ( O, proto )
この関数は呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (O) に設定する。 - proto が
オブジェクトでない かつ proto がnull でない場合、TypeError 例外を投げる。 - O が
オブジェクトでない 場合、O を返す。 - status を ? O.[[SetPrototypeOf]](proto) とする。
- status が
false の場合、TypeError 例外を投げる。 - O を返す。
20.1.2.24 Object.values ( O )
この関数は呼び出されたとき、以下の手順を実行する：
- obj を ?
ToObject (O) とする。 - valueList を ?
EnumerableOwnProperties (obj,value ) とする。 CreateArrayFromList (valueList) を返す。
20.1.3 Objectプロトタイプオブジェクトのプロパティ
Objectプロトタイプオブジェクト：
- %Object.prototype%である。
- [[Extensible]]内部スロットを持ち、その値は
true である。 通常オブジェクト に定義された内部メソッドを持つが、[[SetPrototypeOf]]メソッドは10.4.7.1 に定義される（したがってimmutable prototype exotic object である）。- [[Prototype]]内部スロットを持ち、その値は
null である。
20.1.3.1 Object.prototype.constructor
Object.prototype.constructorの初期値は
20.1.3.2 Object.prototype.hasOwnProperty ( V )
このメソッドは呼び出されたとき、以下の手順を実行する：
- Pを?
ToPropertyKey (V)とする。 - Oを?
ToObject (this 値)とする。 - ?
HasOwnProperty (O, P)を返す。
20.1.3.3 Object.prototype.isPrototypeOf ( V )
このメソッドは呼び出されたとき、以下の手順を実行する：
20.1.3.4 Object.prototype.propertyIsEnumerable ( V )
このメソッドは呼び出されたとき、以下の手順を実行する：
- Pを?
ToPropertyKey (V)とする。 - Oを?
ToObject (this 値)とする。 - descを? O.[[GetOwnProperty]](P)とする。
- descが
undefined の場合、false を返す。 - desc.[[Enumerable]]を返す。
このメソッドはプロトタイプチェーン上のオブジェクトを考慮しない。
20.1.3.5 Object.prototype.toLocaleString ( [reserved1 [ , reserved2 ] ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- Oを
this 値とする。 - ?
Invoke (O,"toString" )を返す。
このメソッドのオプションパラメータは使用されないが、ECMA-402
toLocaleStringメソッドで使われるパラメータパターンに対応することを意図している。ECMA-402サポートがない実装はこれらのパラメータ位置を他の目的に使ってはならない。
このメソッドはロケールに依存しないtoString動作しか持たないオブジェクトのための汎用的なtoLocaleString実装を提供する。Array、Number、Date、toLocaleStringメソッドを提供する。
ECMA-402はこのデフォルト実装に代わるものを意図的に提供していない。
20.1.3.6 Object.prototype.toString ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
this 値がundefined なら、"[object Undefined]" を返す。this 値がnull なら、"[object Null]" を返す。- Oを!
ToObject (this 値)とする。 - isArrayを?
IsArray (O)とする。 - isArrayが
true なら、builtinTagを"Array" とする。 - そうでなくOが[[ParameterMap]]内部スロットを持つ場合、builtinTagを
"Arguments" とする。 - そうでなくOが[[Call]]内部メソッドを持つ場合、builtinTagを
"Function" とする。 - そうでなくOが[[ErrorData]]内部スロットを持つ場合、builtinTagを
"Error" とする。 - そうでなくOが[[BooleanData]]内部スロットを持つ場合、builtinTagを
"Boolean" とする。 - そうでなくOが[[NumberData]]内部スロットを持つ場合、builtinTagを
"Number" とする。 - そうでなくOが[[StringData]]内部スロットを持つ場合、builtinTagを
"String" とする。 - そうでなくOが[[DateValue]]内部スロットを持つ場合、builtinTagを
"Date" とする。 - そうでなくOが[[RegExpMatcher]]内部スロットを持つ場合、builtinTagを
"RegExp" とする。 - そうでなければ、builtinTagを
"Object" とする。 - tagを?
Get (O,%Symbol.toStringTag% )とする。 - tagが
文字列でない 場合、tagをbuiltinTagに設定する。 文字列連結 で"[object " 、tag、"]" を連結して返す。
歴史的に、このメソッドは以前の規格版で様々な組み込みオブジェクトの名目的型タグとして使われていた[[Class]]内部スロットの文字列値にアクセスするために使われることがあった。上記のtoString定義は、toStringをこれら特定の組み込みオブジェクトのテストとして使うレガシーコードとの互換性を維持する。しかし、他の種類の組み込みオブジェクトやプログラム定義オブジェクトに対する信頼できる型テスト機構は提供しない。さらに、プログラムは
20.1.3.7 Object.prototype.valueOf ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- ?
ToObject (this 値)を返す。
20.1.3.8 Object.prototype.__proto__
Object.prototype.__proto__は
20.1.3.8.1 get Object.prototype.__proto__
[[Get]]属性の値は引数なしの組み込み関数であり、呼び出されたとき以下の手順を実行する：
- Oを?
ToObject (this 値)とする。 - ? O.[[GetPrototypeOf]]()を返す。
20.1.3.8.2 set Object.prototype.__proto__
[[Set]]属性の値はproto引数を取る組み込み関数であり、呼び出されたとき以下の手順を実行する：
- Oを?
RequireObjectCoercible (this 値)とする。 - protoが
オブジェクトでない かつprotoがnull でない場合、undefined を返す。 - Oが
オブジェクトでない 場合、undefined を返す。 - statusを? O.[[SetPrototypeOf]](proto)とする。
- statusが
false の場合、TypeError 例外を投げる。 undefined を返す。
20.1.3.9 レガシーObject.prototypeアクセサメソッド
20.1.3.9.1 Object.prototype.__defineGetter__ ( P, getter )
このメソッドは呼び出されたとき、以下の手順を実行する：
- Oを?
ToObject (this 値)とする。 IsCallable (getter)がfalse の場合、TypeError 例外を投げる。- descをPropertyDescriptor { [[Get]]:
getter, [[Enumerable]]:
true , [[Configurable]]:true }とする。 - keyを?
ToPropertyKey (P)とする。 - ?
DefinePropertyOrThrow (O, key, desc)を実行する。 undefined を返す。
20.1.3.9.2 Object.prototype.__defineSetter__ ( P, setter )
このメソッドは呼び出されたとき、以下の手順を実行する：
- Oを?
ToObject (this 値)とする。 IsCallable (setter)がfalse の場合、TypeError 例外を投げる。- descをPropertyDescriptor { [[Set]]:
setter, [[Enumerable]]:
true , [[Configurable]]:true }とする。 - keyを?
ToPropertyKey (P)とする。 - ?
DefinePropertyOrThrow (O, key, desc)を実行する。 undefined を返す。
20.1.3.9.3 Object.prototype.__lookupGetter__ ( P )
このメソッドは呼び出されたとき、以下の手順を実行する：
- Oを?
ToObject (this 値)とする。 - keyを?
ToPropertyKey (P)とする。 - 繰り返し、
- descを? O.[[GetOwnProperty]](key)とする。
- descが
undefined でない場合、IsAccessorDescriptor (desc)がtrue なら、desc.[[Get]]を返す。undefined を返す。
- Oを? O.[[GetPrototypeOf]]()に設定する。
- Oが
null なら、undefined を返す。
20.1.3.9.4 Object.prototype.__lookupSetter__ ( P )
このメソッドは呼び出されたとき、以下の手順を実行する：
- Oを?
ToObject (this 値)とする。 - keyを?
ToPropertyKey (P)とする。 - 繰り返し、
- descを? O.[[GetOwnProperty]](key)とする。
- descが
undefined でない場合、IsAccessorDescriptor (desc)がtrue なら、desc.[[Set]]を返す。undefined を返す。
- Oを? O.[[GetPrototypeOf]]()に設定する。
- Oが
null なら、undefined を返す。
20.1.4 オブジェクトインスタンスのプロパティ
オブジェクトインスタンスは、
20.2 関数オブジェクト
20.2.1 Function コンストラクター
Function
- %Function%である。
"Function" プロパティの初期値であり、グローバルオブジェクト のプロパティである。コンストラクター としてではなく関数として呼び出された場合、新しい関数オブジェクト を作成して初期化する。したがって、Function(…)関数呼び出しは、同じ引数でnew Function(…)オブジェクト生成式と等価である。- クラス定義の
extends節の値として利用できる。指定されたFunctionの動作を継承したいサブクラスコンストラクター は、組み込み関数としての動作に必要な内部スロットを持つサブクラスインスタンスを作成・初期化するためにFunctionコンストラクター へのsuper呼び出しを含めなければならない。関数オブジェクト定義のすべてのECMAScript構文形式はFunctionのインスタンスを生成する。GeneratorFunction、AsyncFunction、AsyncGeneratorFunctionの組み込みサブクラスを除き、Functionサブクラスのインスタンスを生成する構文手段は存在しない。
20.2.1.1 Function ( ...parameterArgs, bodyArg )
最後の引数（存在する場合）は関数本体（実行コード）を指定し、それ以外の引数は形式的なパラメータを指定する。
この関数は呼び出されたとき、以下の手順を実行する：
- Cを
アクティブ関数オブジェクト とする。 - bodyArgが存在しない場合、bodyArgを空文字列とする。
- ?
CreateDynamicFunction (C, NewTarget,normal , parameterArgs, bodyArg)を返す。
指定する形式パラメータごとに引数を1つずつ持ってもよいが、必須ではない。例えば、以下の3つの式は同じ結果を生む：
new Function("a", "b", "c", "return a+b+c")
new Function("a, b, c", "return a+b+c")
new Function("a,b", "c", "return a+b+c")20.2.1.1.1 CreateDynamicFunction ( constructor, newTarget, kind, parameterArgs, bodyArg )
抽象演算CreateDynamicFunctionは、引数constructor（newが最初に適用された
- newTargetが
undefined なら、newTargetをconstructorに設定する。 - kindが
normal なら、- prefixを
"function" とする。 - exprSymを
FunctionExpression とする。 - bodySymを
FunctionBody [~Yield, ~Await] - parameterSymを
FormalParameters [~Yield, ~Await] - fallbackProtoを
"%Function.prototype%" とする。
- prefixを
- そうでなくkindが
generator なら、- prefixを
"function*" とする。 - exprSymを
GeneratorExpression とする。 - bodySymを
GeneratorBody とする。 - parameterSymを
FormalParameters [+Yield, ~Await] - fallbackProtoを
"%GeneratorFunction.prototype%" とする。
- prefixを
- そうでなくkindが
async なら、- prefixを
"async function" とする。 - exprSymを
AsyncFunctionExpression とする。 - bodySymを
AsyncFunctionBody とする。 - parameterSymを
FormalParameters [~Yield, +Await] - fallbackProtoを
"%AsyncFunction.prototype%" とする。
- prefixを
- そうでなければ、
アサート : kindはasync-generator である。- prefixを
"async function*" とする。 - exprSymを
AsyncGeneratorExpression とする。 - bodySymを
AsyncGeneratorBody とする。 - parameterSymを
FormalParameters [+Yield, +Await] - fallbackProtoを
"%AsyncGeneratorFunction.prototype%" とする。
- argCountをparameterArgsの要素数とする。
- parameterStringsを新しい空の
List とする。 - parameterArgsの各要素argについて、
- ?
ToString (arg)をparameterStringsに追加する。
- ?
- bodyStringを?
ToString (bodyArg)とする。 - currentRealmを
現在のRealm Record とする。 - ?
HostEnsureCanCompileStrings (currentRealm, parameterStrings, bodyString,false )を実行する。 - Pを空文字列とする。
- argCount > 0なら、
- PをparameterStrings[0]に設定する。
- kを1とする。
- k < argCountの間繰り返し、
- nextArgStringをparameterStrings[k]とする。
- Pを
文字列連結 (P,"," 、nextArgString)に設定する。 - kをk + 1に設定する。
- bodyParseStringを
文字列連結 (0x000A (LINE FEED), bodyString, 0x000A (LINE FEED))とする。 - sourceStringを
文字列連結 (prefix," anonymous(" , P, 0x000A (LINE FEED),") {" , bodyParseString,"}" )とする。 - sourceTextを
StringToCodePoints (sourceString)とする。 - parametersを
ParseText (P, parameterSym)とする。 - parametersがエラーの
List なら、SyntaxError 例外を投げる。 - bodyを
ParseText (bodyParseString, bodySym)とする。 - bodyがエラーの
List なら、SyntaxError 例外を投げる。 - 注:
パラメータと本体は個別にパースされ、それぞれが単独で有効か検証される。例えば
new Function("/*", "*/ ) {")は関数にならない。 - 注: この手順に到達した場合、sourceTextはexprSymの構文を持つ（逆は保証されない）。次の2ステップはexprSymに直接適用されるEarly Errorルールを強制するためである。
- exprを
ParseText (sourceText, exprSym)とする。 - exprがエラーの
List なら、SyntaxError 例外を投げる。 - protoを?
GetPrototypeFromConstructor (newTarget, fallbackProto)とする。 - envをcurrentRealm.[[GlobalEnv]]とする。
- privateEnvを
null とする。 - Fを
OrdinaryFunctionCreate (proto, sourceText, parameters, body,non-lexical-this , env, privateEnv)とする。 SetFunctionName (F,"anonymous" )を実行する。- kindが
generator なら、- prototypeを
OrdinaryObjectCreate (%GeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。
- prototypeを
- そうでなくkindが
async-generator なら、- prototypeを
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。
- prototypeを
- そうでなくkindが
normal なら、MakeConstructor (F)を実行する。
- 注: kindが
async の関数は構築不可能であり、[[Construct]]内部メソッドや"prototype" プロパティを持たない。 - Fを返す。
CreateDynamicFunctionは、kindが
20.2.2 Functionコンストラクターのプロパティ
Function
- 自身が組み込みの
関数オブジェクト である。 - [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 "length" プロパティを持ち、その値は1 𝔽である。- 以下のプロパティを持つ：
20.2.2.1 Function.prototype
Function.prototypeの値は
このプロパティの属性は{ [[Writable]]:
20.2.3 Functionプロトタイプオブジェクトのプロパティ
Functionプロトタイプオブジェクト：
- %Function.prototype%である。
- 自身が組み込みの
関数オブジェクト である。 - どんな引数でも受け取り、呼び出されると
undefined を返す。 - [[Construct]]内部メソッドを持たないため、
new演算子によるコンストラクター として使用できない。 - [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 "prototype" プロパティを持たない。"length" プロパティを持ち、その値は+0 𝔽である。"name" プロパティを持ち、その値は空文字列である。
Functionプロトタイプオブジェクトは、ECMAScript 2015規格以前に作成されたECMAScriptコードとの互換性を確保するため
20.2.3.1 Function.prototype.apply ( thisArg, argArray )
このメソッドは呼び出されたとき、以下の手順を実行する：
- funcを
this 値とする。 IsCallable (func)がfalse の場合、TypeError 例外を投げる。- argArrayが
undefined またはnull の場合、PrepareForTailCall ()を実行する。- ?
Call (func, thisArg)を返す。
- argListを?
CreateListFromArrayLike (argArray)とする。 PrepareForTailCall ()を実行する。- ?
Call (func, thisArg, argList)を返す。
thisArg値は修飾なしに
funcがアロー関数や
20.2.3.2 Function.prototype.bind ( thisArg, ...args )
このメソッドは呼び出されたとき、以下の手順を実行する：
- Targetを
this 値とする。 IsCallable (Target)がfalse の場合、TypeError 例外を投げる。- Fを?
BoundFunctionCreate (Target, thisArg, args)とする。 - Lを0とする。
- targetHasLengthを?
HasOwnProperty (Target,"length" )とする。 - targetHasLengthが
true なら、 SetFunctionLength (F, L)を実行する。- targetNameを?
Get (Target,"name" )とする。 - targetNameが
文字列でない 場合、targetNameを空文字列に設定する。 SetFunctionName (F, targetName,"bound" )を実行する。- Fを返す。
Function.prototype.bindで作成すると
Targetがアロー関数や
20.2.3.3 Function.prototype.call ( thisArg, ...args )
このメソッドは呼び出されたとき、以下の手順を実行する：
- funcを
this 値とする。 IsCallable (func)がfalse の場合、TypeError 例外を投げる。PrepareForTailCall ()を実行する。- ?
Call (func, thisArg, args)を返す。
thisArg値は修飾なしに
funcがアロー関数や
20.2.3.4 Function.prototype.constructor
Function.prototype.constructorの初期値は
20.2.3.5 Function.prototype.toString ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- funcを
this 値とする。 - funcが
オブジェクトである 、funcが[[SourceText]]内部スロットを持ち、func.[[SourceText]]がUnicodeコードポイントの列であり、HostHasSourceTextAvailable (func)がtrue なら、CodePointsToString (func.[[SourceText]])を返す。
- funcが
組み込み関数オブジェクト なら、funcの実装定義 の文字列ソースコード表現を返す。表現はNativeFunction の構文を持たなければならない。さらにfuncが[[InitialName]]内部スロットを持ち、func.[[InitialName]]が文字列 の場合、返される文字列のうちNativeFunctionAccessor opt PropertyName に一致する部分はfunc.[[InitialName]]でなければならない。 - funcが
オブジェクト でIsCallable (func)がtrue の場合、funcの実装定義 の文字列ソースコード表現を返す。表現はNativeFunction の構文を持たなければならない。 TypeError 例外を投げる。
20.2.3.6 Function.prototype [ %Symbol.hasInstance% ] ( V )
このメソッドは呼び出されたとき、以下の手順を実行する：
- Fを
this 値とする。 - ?
OrdinaryHasInstance (F, V)を返す。
このプロパティの属性は{ [[Writable]]:
このプロパティは書き換え不可・設定不可であり、束縛関数の対象関数をグローバルに露出させるような改変を防ぐためのものである。
このメソッドの
20.2.4 関数インスタンス
すべてのFunctionインスタンスはECMAScriptのFunction.prototype.bindメソッド(
Functionインスタンスは次のプロパティを持つ：
20.2.4.1 length
20.2.4.2 name
この規格で文脈的な名前が関連付けられていない匿名関数オブジェクトは、
20.2.4.3 prototype
このプロパティの属性は{ [[Writable]]:
Function.prototype.bindで作成された
20.2.5 HostHasSourceTextAvailable ( func )
HostHasSourceTextAvailableの実装は次の要件を満たさなければならない：
- パラメータに対して決定論的でなければならない。特定のfuncを引数として呼び出した際、常に同じ結果を返す必要がある。
HostHasSourceTextAvailableのデフォルト実装は
20.3 Booleanオブジェクト
20.3.1 Booleanコンストラクター
Boolean
- %Boolean%である。
"Boolean" プロパティの初期値であり、グローバルオブジェクト のプロパティである。コンストラクター として呼び出された場合、新しいBooleanオブジェクトを作成して初期化する。- 関数として呼び出された場合は型変換を行うが、
コンストラクター として呼び出された場合とは異なる。 - クラス定義の
extends節の値として使用できる。指定されたBooleanの動作を継承したいサブクラスコンストラクター は、Booleanコンストラクター へのsuper呼び出しを含めなければならず、サブクラスインスタンスに[[BooleanData]]内部スロットを作成・初期化する。
20.3.1.1 Boolean ( value )
この関数は呼び出されたとき、以下の手順を実行する：
- bを
ToBoolean (value)とする。 - NewTargetが
undefined の場合、bを返す。 - Oを?
OrdinaryCreateFromConstructor (NewTarget,"%Boolean.prototype%" , « [[BooleanData]] »)とする。 - O.[[BooleanData]]にbを設定する。
- Oを返す。
20.3.2 Booleanコンストラクターのプロパティ
Boolean
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
20.3.2.1 Boolean.prototype
Boolean.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
20.3.3 Booleanプロトタイプオブジェクトのプロパティ
Booleanプロトタイプオブジェクト：
- %Boolean.prototype%である。
通常オブジェクト である。- 自身がBooleanオブジェクトであり、[[BooleanData]]内部スロットに
false を持つ。 - [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。
20.3.3.1 Boolean.prototype.constructor
Boolean.prototype.constructorの初期値は
20.3.3.2 Boolean.prototype.toString ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- bを?
ThisBooleanValue (this 値)とする。 - bが
true なら"true" を返し、そうでなければ"false" を返す。
20.3.3.3 Boolean.prototype.valueOf ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- ?
ThisBooleanValue (this 値)を返す。
20.3.3.3.1 ThisBooleanValue ( value )
抽象演算ThisBooleanValueは、引数value（
20.3.4 Booleanインスタンスのプロパティ
Booleanインスタンスは
20.4 Symbolオブジェクト
20.4.1 Symbolコンストラクター
Symbol
- %Symbol%である。
"Symbol" プロパティの初期値であり、グローバルオブジェクト のプロパティである。- 関数として呼び出されると新しいSymbol値を返す。
new演算子とともに使用することは意図されていない。- サブクラス化は意図されていない。
- クラス定義の
extends節の値として使用できるが、これにsuper呼び出しを行うと例外が発生する。
20.4.1.1 Symbol ( [ description ] )
この関数は呼び出されたとき、以下の手順を実行する：
- NewTargetが
undefined でない場合、TypeError 例外を投げる。 - descriptionが
undefined の場合、descStringをundefined とする。 - そうでなければ、descStringを?
ToString (description)とする。 - [[Description]]がdescStringである新しいSymbolを返す。
20.4.2 Symbolコンストラクターのプロパティ
Symbol
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
20.4.2.1 Symbol.asyncIterator
Symbol.asyncIteratorの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.2 Symbol.for ( key )
この関数は呼び出されたとき、以下の手順を実行する：
- stringKeyを?
ToString (key)とする。 GlobalSymbolRegistry List の各要素eについて、- e.[[Key]]がstringKeyなら、e.[[Symbol]]を返す。
アサート :GlobalSymbolRegistry List には現在stringKeyのエントリが存在しない。- [[Description]]がstringKeyである新しいSymbolnewSymbolを作成する。
- GlobalSymbolRegistryに
Record { [[Key]]: stringKey, [[Symbol]]: newSymbol } を追加する。 - newSymbolを返す。
GlobalSymbolRegistry Listは、全体で利用可能な追加専用の
20.4.2.3 Symbol.hasInstance
Symbol.hasInstanceの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.4 Symbol.isConcatSpreadable
Symbol.isConcatSpreadableの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.5 Symbol.iterator
Symbol.iteratorの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.6 Symbol.keyFor ( sym )
この関数は呼び出されたとき、以下の手順を実行する：
- symが
Symbol型でない 場合、TypeError 例外を投げる。 KeyForSymbol (sym)を返す。
20.4.2.7 Symbol.match
Symbol.matchの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.8 Symbol.matchAll
Symbol.matchAllの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.9 Symbol.prototype
Symbol.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
20.4.2.10 Symbol.replace
Symbol.replaceの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.11 Symbol.search
Symbol.searchの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.12 Symbol.species
Symbol.speciesの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.13 Symbol.split
Symbol.splitの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.14 Symbol.toPrimitive
Symbol.toPrimitiveの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.15 Symbol.toStringTag
Symbol.toStringTagの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.2.16 Symbol.unscopables
Symbol.unscopablesの初期値は、よく知られたシンボル
このプロパティの属性は { [[Writable]]:
20.4.3 Symbolプロトタイプオブジェクトのプロパティ
Symbolプロトタイプオブジェクト：
- %Symbol.prototype%である。
通常オブジェクト である。Symbol インスタンスではなく、[[SymbolData]]内部スロットを持たない。- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。
20.4.3.1 Symbol.prototype.constructor
Symbol.prototype.constructorの初期値は
20.4.3.2 get Symbol.prototype.description
Symbol.prototype.descriptionは
- sを
this 値とする。 - symを?
ThisSymbolValue (s)とする。 - sym.[[Description]]を返す。
20.4.3.3 Symbol.prototype.toString ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- symを?
ThisSymbolValue (this 値)とする。 SymbolDescriptiveString (sym)を返す。
20.4.3.3.1 SymbolDescriptiveString ( sym )
抽象演算SymbolDescriptiveStringは、引数sym(Symbol)を受け取り、文字列を返す。呼び出されたとき、以下の手順を実行する：
20.4.3.4 Symbol.prototype.valueOf ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- ?
ThisSymbolValue (this 値)を返す。
20.4.3.4.1 ThisSymbolValue ( value )
抽象演算ThisSymbolValueは、引数value（
20.4.3.5 Symbol.prototype [ %Symbol.toPrimitive% ] ( hint )
このメソッドはECMAScript言語の演算子によってSymbolオブジェクトをプリミティブ値に変換するために呼び出される。
呼び出されたとき、以下の手順を実行する：
- ?
ThisSymbolValue (this 値)を返す。
引数は無視される。
このプロパティの属性は { [[Writable]]:
このメソッドの
20.4.3.6 Symbol.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
20.4.4 Symbolインスタンスのプロパティ
Symbolインスタンスは
20.4.5 Symbolのための抽象演算
20.4.5.1 KeyForSymbol ( sym )
抽象演算KeyForSymbolは、引数sym(Symbol)を受け取り、文字列または
GlobalSymbolRegistry List の各要素eについて、SameValue (e.[[Symbol]], sym)がtrue なら、e.[[Key]]を返す。
アサート :GlobalSymbolRegistry List には現在symのエントリが存在しない。undefined を返す。
20.5 エラーオブジェクト
Errorオブジェクトのインスタンスは、実行時エラーが発生したとき例外としてスローされる。Errorオブジェクトは、ユーザー定義の例外クラスの基底オブジェクトとしても利用できる。
ECMAScript実装が実行時エラーを検出した場合、
20.5.1 Errorコンストラクター
Error
- %Error%である。
"Error" プロパティの初期値であり、グローバルオブジェクト のプロパティである。- 関数として呼び出された場合、新しいErrorオブジェクトを作成し初期化する。したがって、関数呼び出し
Error(…)は、同じ引数でのオブジェクト生成式new Error(…)と等価である。 - クラス定義の
extends節の値として利用できる。指定されたErrorの動作を継承したいサブクラスコンストラクター は、Errorコンストラクター へのsuper呼び出しを含め、サブクラスインスタンスに[[ErrorData]]内部スロットを作成・初期化しなければならない。
20.5.1.1 Error ( message [ , options ] )
この関数は呼び出されたとき、以下の手順を実行する：
- NewTargetが
undefined なら、newTargetをアクティブ関数オブジェクト とし、そうでなければnewTargetをNewTargetとする。 - Oを?
OrdinaryCreateFromConstructor (newTarget,"%Error.prototype%" , « [[ErrorData]] »)とする。 - messageが
undefined でない場合、- msgを?
ToString (message)とする。 CreateNonEnumerableDataPropertyOrThrow (O,"message" , msg)を実行する。
- msgを?
- ?
InstallErrorCause (O, options)を実行する。 - Oを返す。
20.5.2 Errorコンストラクターのプロパティ
Error
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
20.5.2.1 Error.isError ( arg )
この関数は呼び出されたとき、以下の手順を実行する：
- argが
オブジェクトでない 場合、false を返す。 - argが[[ErrorData]]内部スロットを持たない場合、
false を返す。 true を返す。
20.5.2.2 Error.prototype
Error.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
20.5.3 Errorプロトタイプオブジェクトのプロパティ
Errorプロトタイプオブジェクト：
- %Error.prototype%である。
通常オブジェクト である。- Errorインスタンスではなく、[[ErrorData]]内部スロットを持たない。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。
20.5.3.1 Error.prototype.constructor
Error.prototype.constructorの初期値は
20.5.3.2 Error.prototype.message
Error.prototype.messageの初期値は空文字列である。
20.5.3.3 Error.prototype.name
Error.prototype.nameの初期値は
20.5.3.4 Error.prototype.toString ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- Oを
this 値とする。 - Oが
オブジェクトでない 場合、TypeError 例外を投げる。 - nameを?
Get (O,"name" )とする。 - nameが
undefined なら、nameを"Error" に設定し、そうでなければ?ToString (name)に設定する。 - msgを?
Get (O,"message" )とする。 - msgが
undefined なら、msgを空文字列に設定し、そうでなければ?ToString (msg)に設定する。 - nameが空文字列ならmsgを返す。
- msgが空文字列ならnameを返す。
文字列連結 (name, コード単位0x003A（コロン）, コード単位0x0020（スペース）, msg)を返す。
20.5.4 Errorインスタンスのプロパティ
ErrorインスタンスはObject.prototype.toStringとError.isErrorでErrorオブジェクトとして識別することである。
20.5.5 本規格で使用されるNative Error型
実行時エラーが検出された場合、以下のNativeErrorオブジェクトまたはAggregateErrorオブジェクトの新しいインスタンスがスローされる。すべてのNativeErrorオブジェクトは、
20.5.5.1 EvalError
EvalError
この例外は現在本規格内では使用されていない。このオブジェクトは以前の規格との互換性のために残されている。
20.5.5.2 RangeError
RangeError
許容される値の集合または範囲に含まれない値を示す。
20.5.5.3 ReferenceError
ReferenceError
無効な参照が検出されたことを示す。
20.5.5.4 SyntaxError
SyntaxError
構文解析エラーが発生したことを示す。
20.5.5.5 TypeError
TypeError
他のNativeErrorオブジェクトが失敗原因の適切な指示となり得ない場合、TypeErrorは不成功な操作を示すために使われる。
20.5.5.6 URIError
URIError
グローバルなURI処理関数のいずれかが、その定義と互換性のない方法で使用されたことを示す。
20.5.6 NativeErrorオブジェクトの構造
各オブジェクトは以下で説明する構造を持ち、
各エラーオブジェクトの定義内のNativeErrorへの参照は、
20.5.6.1 NativeErrorコンストラクター
各NativeError
- 関数として呼び出された場合、新しいNativeErrorオブジェクトを作成し初期化する。関数として呼び出すことは、同じ引数で
コンストラクター として呼び出すことと等価である。したがって、NativeError(…)関数呼び出しは、オブジェクト生成式new NativeError(…)と等価である。 - クラス定義の
extends節の値として利用できる。指定されたNativeErrorの動作を継承したいサブクラスコンストラクター は、NativeErrorコンストラクター へのsuper呼び出しを含め、サブクラスインスタンスに[[ErrorData]]内部スロットを作成・初期化しなければならない。
20.5.6.1.1 NativeError ( message [ , options ] )
各NativeError関数は呼び出されたとき、以下の手順を実行する：
- NewTargetが
undefined なら、newTargetをアクティブ関数オブジェクト とし、そうでなければnewTargetをNewTargetとする。 - Oを?
OrdinaryCreateFromConstructor (newTarget,"%NativeError.prototype%", « [[ErrorData]] »)とする。 - messageが
undefined でない場合、- msgを?
ToString (message)とする。 CreateNonEnumerableDataPropertyOrThrow (O,"message" , msg)を実行する。
- msgを?
- ?
InstallErrorCause (O, options)を実行する。 - Oを返す。
step
20.5.6.2 NativeErrorコンストラクターのプロパティ
各NativeError
- [[Prototype]]内部スロットを持ち、その値は
%Error% である。 "name" プロパティを持ち、その値は文字列値"NativeError" である。- 以下のプロパティを持つ：
20.5.6.2.1 NativeError.prototype
NativeError.prototypeの初期値はNativeErrorプロトタイプオブジェクト（
このプロパティの属性は { [[Writable]]:
20.5.6.3 NativeErrorプロトタイプオブジェクトのプロパティ
NativeErrorプロトタイプオブジェクト：
通常オブジェクト である。- Errorインスタンスではなく、[[ErrorData]]内部スロットを持たない。
- [[Prototype]]内部スロットを持ち、その値は
%Error.prototype% である。
20.5.6.3.1 NativeError.prototype.constructor
各NativeError
20.5.6.3.2 NativeError.prototype.message
各NativeError
20.5.6.3.3 NativeError.prototype.name
各NativeError
20.5.6.4 NativeErrorインスタンスのプロパティ
NativeErrorインスタンスはObject.prototype.toString（Error.isError（
20.5.7 AggregateErrorオブジェクト
20.5.7.1 AggregateErrorコンストラクター
AggregateError
- %AggregateError%である。
"AggregateError" プロパティの初期値であり、グローバルオブジェクト のプロパティである。- 関数として呼び出された場合、新しいAggregateErrorオブジェクトを作成し初期化する。したがって、関数呼び出し
AggregateError(…)は、同じ引数でのオブジェクト生成式new AggregateError(…)と等価である。 - クラス定義の
extends節の値として利用できる。指定されたAggregateErrorの動作を継承したいサブクラスコンストラクター は、AggregateErrorコンストラクター へのsuper呼び出しを含め、サブクラスインスタンスに[[ErrorData]]内部スロットを作成・初期化しなければならない。
20.5.7.1.1 AggregateError ( errors, message [ , options ] )
この関数は呼び出されたとき、以下の手順を実行する：
- NewTargetが
undefined なら、newTargetをアクティブ関数オブジェクト とし、そうでなければnewTargetをNewTargetとする。 - Oを?
OrdinaryCreateFromConstructor (newTarget,"%AggregateError.prototype%" , « [[ErrorData]] »)とする。 - messageが
undefined でない場合、- msgを?
ToString (message)とする。 CreateNonEnumerableDataPropertyOrThrow (O,"message" , msg)を実行する。
- msgを?
- ?
InstallErrorCause (O, options)を実行する。 - errorsListを?
IteratorToList (?GetIterator (errors,sync ))とする。 - !
DefinePropertyOrThrow (O,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errorsList) })を実行する。 - Oを返す。
20.5.7.2 AggregateErrorコンストラクターのプロパティ
AggregateError
- [[Prototype]]内部スロットを持ち、その値は
%Error% である。 - 以下のプロパティを持つ：
20.5.7.2.1 AggregateError.prototype
AggregateError.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
20.5.7.3 AggregateErrorプロトタイプオブジェクトのプロパティ
AggregateErrorプロトタイプオブジェクト：
- %AggregateError.prototype%である。
通常オブジェクト である。- ErrorインスタンスまたはAggregateErrorインスタンスではなく、[[ErrorData]]内部スロットを持たない。
- [[Prototype]]内部スロットを持ち、その値は
%Error.prototype% である。
20.5.7.3.1 AggregateError.prototype.constructor
AggregateError.prototype.constructorの初期値は
20.5.7.3.2 AggregateError.prototype.message
AggregateError.prototype.messageの初期値は空文字列である。
20.5.7.3.3 AggregateError.prototype.name
AggregateError.prototype.nameの初期値は
20.5.7.4 AggregateErrorインスタンスのプロパティ
AggregateErrorインスタンスはObject.prototype.toString（Error.isError（
20.5.8 エラーオブジェクトのための抽象演算
20.5.8.1 InstallErrorCause ( O, options )
抽象演算InstallErrorCauseは、引数O（オブジェクト）とoptions（
- optionsが
オブジェクト であり、?HasProperty (options,"cause" )がtrue の場合、- causeを?
Get (options,"cause" )とする。 CreateNonEnumerableDataPropertyOrThrow (O,"cause" , cause)を実行する。
- causeを?
unused を返す。
21 数値と日付
21.1 数値オブジェクト
21.1.1 Number コンストラクター
Number
- %Number%である。
"Number" プロパティの初期値はグローバルオブジェクト である。コンストラクター として呼び出されたとき、新しい Number オブジェクトを作成および初期化する。- 関数として呼び出された場合は型変換を行い、
コンストラクター としてではない。 extends句の値として使用できる。指定された Number の動作を継承するサブクラスコンストラクター は、superで Numberコンストラクター を呼び出し、サブクラスインスタンスを [[NumberData]] 内部スロットで作成・初期化する必要がある。
21.1.1.1 Number ( value )
この関数は呼び出されたとき、以下の手順を実行する:
- valueが存在する場合:
- primを ?
ToNumeric (value)とする。 - prim
BigInt である場合 、nを𝔽 (ℝ (prim))とする。 - それ以外の場合、nをprimとする。
- primを ?
- それ以外の場合:
- nを
+0 𝔽とする。
- nを
- NewTargetが
undefined なら、nを返す。 - Oを ?
OrdinaryCreateFromConstructor (NewTarget,"%Number.prototype%" , « [[NumberData]] ») - O.[[NumberData]]をnに設定する。
- Oを返す。
21.1.2 Number コンストラクターのプロパティ
Number
- [[Prototype]]内部スロットの値は
%Function.prototype% である。 - 次のプロパティを持つ:
21.1.2.1 Number.EPSILON
Number.EPSILONの値は、1 より大きい最小の Number 値と 1 の差の大きさの
このプロパティは属性 { [[Writable]]:
21.1.2.2 Number.isFinite ( number )
この関数は呼び出された時、以下の手順を実行する:
- numberが
Number でない場合 、false を返す。 - numberが
有限 でない場合、false を返す。 - それ以外の場合、
true を返す。
21.1.2.3 Number.isInteger ( number )
この関数は呼び出された時、以下の手順を実行する:
- numberが
整数 Number の場合、true を返す。 false を返す。
21.1.2.4 Number.isNaN ( number )
この関数は呼び出された時、以下の手順を実行する:
- numberが
Number でない場合 、false を返す。 - numberが
NaN の場合、true を返す。 - それ以外の場合、
false を返す。
この関数はグローバル isNaN 関数 (
21.1.2.5 Number.isSafeInteger ( number )
この関数は呼び出された時、以下の手順を実行する:
21.1.2.6 Number.MAX_SAFE_INTEGER
Number.MAX_SAFE_INTEGERの値は
このプロパティは属性 { [[Writable]]:
21.1.2.7 Number.MAX_VALUE
Number.MAX_VALUEの値は
このプロパティは属性 { [[Writable]]:
21.1.2.8 Number.MIN_SAFE_INTEGER
Number.MIN_SAFE_INTEGERの値は
このプロパティは属性 { [[Writable]]:
21.1.2.9 Number.MIN_VALUE
Number.MIN_VALUEの値は
Number.MIN_VALUEの値は実装で実際に表現可能な最小の非ゼロ正値にする必要がある。
このプロパティは属性 { [[Writable]]:
21.1.2.10 Number.NaN
Number.NaNの値は
このプロパティは属性 { [[Writable]]:
21.1.2.11 Number.NEGATIVE_INFINITY
Number.NEGATIVE_INFINITYの値は
このプロパティは属性 { [[Writable]]:
21.1.2.12 Number.parseFloat ( string )
21.1.2.13 Number.parseInt ( string, radix )
21.1.2.14 Number.POSITIVE_INFINITY
Number.POSITIVE_INFINITYの値は
このプロパティは属性 { [[Writable]]:
21.1.2.15 Number.prototype
Number.prototypeの初期値は
このプロパティは属性 { [[Writable]]:
21.1.3 Number プロトタイプオブジェクトのプロパティ
Number プロトタイプオブジェクトは以下の通りです:
- %Number.prototype%である。
通常のオブジェクト である。- 自身も Number オブジェクトであり、[[NumberData]]内部スロットに
+0 𝔽の値を持つ。 - [[Prototype]]内部スロットの値は
%Object.prototype% である。
明示的に記載がない限り、以下に定義する Number プロトタイプオブジェクトのメソッドはジェネリックではなく、
メソッド仕様内の「this Number値」という表現は、抽象操作
21.1.3.1 Number.prototype.constructor
Number.prototype.constructorの初期値は
21.1.3.2 Number.prototype.toExponential ( fractionDigits )
このメソッドは、この Number
値を、仮数部の小数点の前に1桁、fractionDigits桁の小数点以下を持つ10進指数表記で表した文字列を返す。fractionDigitsが
呼び出されたとき、次の手順を実行する:
- xを?
ThisNumberValue (this 値)とする。 - fを?
ToIntegerOrInfinity (fractionDigits)とする。 Assert : fractionDigitsがundefined の場合、fは0である。- xが
有限 でない場合、Number::toString (x, 10)を返す。 - fが0未満または100より大きい場合、
RangeError 例外を投げる。 - xを
ℝ (x)に設定する。 - sを空文字列とする。
- xが0未満の場合:
- sを
"-" にする。 - xを-xにする。
- sを
- xが0の場合:
- mを、コード単位0x0030（数字のゼロ）がf+1回並ぶ文字列とする。
- eを0とする。
- それ以外の場合:
- f ≠ 0 の場合:
- aをmの最初のコード単位とする。
- bをmの残りのfコード単位とする。
- mを、a、
"." 、bを連結 したものとする。
- e = 0 の場合:
- cを
"+" にする。 - dを
"0" にする。
- cを
- それ以外の場合:
- e > 0 の場合:
- cを
"+" にする。
- cを
- それ以外の場合:
Assert : e < 0。- cを
"-" にする。 - eを-eにする。
- dをeの10進表現の桁（順序通り・先頭ゼロなし）で構成される文字列とする。
- e > 0 の場合:
- mを、m、
"e" 、c、dを連結 したものにする。 - sとmを
連結 したものを返す。
21.1.3.3 Number.prototype.toFixed ( fractionDigits )
このメソッドは、この Number
値を小数点以下fractionDigits桁の10進固定小数点表記で表した文字列を返す。fractionDigitsが
呼び出されたとき、次の手順を実行する:
- xを?
ThisNumberValue (this 値)とする。 - fを?
ToIntegerOrInfinity (fractionDigits)とする。 Assert : fractionDigitsがundefined の場合、fは0である。- fが
有限 でない場合、RangeError 例外を投げる。 - fが0未満または100より大きい場合、
RangeError 例外を投げる。 - xが
有限 でない場合、Number::toString (x, 10)を返す。 - xを
ℝ (x)に設定する。 - sを空文字列とする。
- xが0未満の場合:
- sを
"-" にする。 - xを-xにする。
- sを
- x ≥ 1021の場合:
- それ以外の場合:
- sとmを
連結 したものを返す。
toFixedの出力は、toStringが隣接するNumber値と区別できるだけの有効数字しか表示しないため、一部の値についてtoStringよりも高精度になる場合がある。例:
(1000000000000000128).toString()は
(1000000000000000128).toFixed(0)は
21.1.3.4 Number.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402国際化APIを含むECMAScript実装は、ECMA-402仕様に従ってこのメソッドを実装しなければならない。ECMA-402 APIを含まない場合は、以下の仕様による:
このメソッドは、このNumber値を
このメソッドのオプションパラメータの意味はECMA-402仕様で定義されている。ECMA-402非対応の実装は、これらのパラメータ位置を他用途に使ってはならない。
21.1.3.5 Number.prototype.toPrecision ( precision )
このメソッドは、このNumber値を、仮数部の小数点の前に1桁、
呼び出されたとき、次の手順を実行する:
- xを?
ThisNumberValue (this 値)とする。 - precisionが
undefined の場合、!ToString (x)を返す。 - pを?
ToIntegerOrInfinity (precision)とする。 - xが
有限 でない場合、Number::toString (x, 10)を返す。 - pが1未満または100より大きい場合、
RangeError 例外を投げる。 - xを
ℝ (x)に設定する。 - sを空文字列とする。
- xが0未満の場合:
- sをコード単位0x002D（ハイフンマイナス）にする。
- xを-xにする。
- xが0の場合:
- mを、コード単位0x0030（数字のゼロ）がp回並ぶ文字列とする。
- eを0とする。
- それ以外の場合:
- eとnを
整数 とし、10p - 1 ≤ n < 10pかつn × 10e - p + 1 - xが最もゼロに近いものとする。2つ該当する場合は、n × 10e - p + 1が大きい方を選ぶ。 - mをnの10進表現の桁（順序通り・先頭ゼロなし）で構成される文字列とする。
- e < -6 または e ≥ p の場合:
- eとnを
- e = p - 1 の場合、sとmを
連結 したものを返す。 - e ≥ 0 の場合:
- mを、mの先頭e+1コード単位、コード単位0x002E（ピリオド）、残りのp-(e+1)コード単位を
連結 したものにする。
- mを、mの先頭e+1コード単位、コード単位0x002E（ピリオド）、残りのp-(e+1)コード単位を
- それ以外の場合:
- mを、コード単位0x0030（数字のゼロ）、コード単位0x002E（ピリオド）、-（e+1）回のコード単位0x0030（数字のゼロ）、mを
連結 したものにする。
- mを、コード単位0x0030（数字のゼロ）、コード単位0x002E（ピリオド）、-（e+1）回のコード単位0x0030（数字のゼロ）、mを
- sとmを
連結 したものを返す。
21.1.3.6 Number.prototype.toString ( [ radix ] )
オプションのradixは、
このメソッドは呼び出されたとき、以下の手順を実行する:
- xを?
ThisNumberValue (this 値)とする。 - radixが
undefined の場合、radixMVを10とする。 - それ以外の場合、radixMVを?
ToIntegerOrInfinity (radix)とする。 - radixMVが2から36の
区間 にない場合、RangeError 例外を投げる。 Number::toString (x, radixMV)を返す。
このメソッドはジェネリックではない;
このメソッドの
21.1.3.7 Number.prototype.valueOf ( )
- ?
ThisNumberValue (this 値)を返す。
21.1.3.7.1 ThisNumberValue ( value )
抽象操作ThisNumberValueは引数value（
21.1.4 Numberインスタンスのプロパティ
Numberインスタンスは
21.2 BigInt オブジェクト
21.2.1 BigInt コンストラクター
BigInt
- %BigInt%である。
"BigInt" プロパティの初期値はグローバルオブジェクト である。- 関数として呼び出された場合は型変換を行い、
コンストラクター としてではない。 new演算子で使用したり、サブクラス化することを意図していない。extends句の値として使用できるが、BigIntコンストラクター へのsuper呼び出しは例外を発生させる。
21.2.1.1 BigInt ( value )
この関数は呼び出されたとき、以下の手順を実行する:
- NewTargetが
undefined でない場合、TypeError 例外を投げる。 - primを?
ToPrimitive (value,number )とする。 - primが
Numberである場合 、?NumberToBigInt (prim)を返す。 - それ以外の場合、?
ToBigInt (prim)を返す。
21.2.1.1.1 NumberToBigInt ( number )
抽象操作 NumberToBigInt は引数 number（Number型）を取り、
- numberが
整数Numberでない場合 、RangeError 例外を投げる。 ℤ (ℝ (number))を返す。
21.2.2 BigInt コンストラクターのプロパティ
BigInt
- [[Prototype]]内部スロットの値は
%Function.prototype% である。 - 次のプロパティを持つ:
21.2.2.1 BigInt.asIntN ( bits, bigint )
この関数は呼び出されたとき、以下の手順を実行する:
21.2.2.2 BigInt.asUintN ( bits, bigint )
この関数は呼び出されたとき、以下の手順を実行する:
21.2.2.3 BigInt.prototype
BigInt.prototypeの初期値は
このプロパティは属性 { [[Writable]]:
21.2.3 BigInt プロトタイプオブジェクトのプロパティ
BigInt プロトタイプオブジェクトは以下の通りです:
- %BigInt.prototype%である。
通常のオブジェクト である。BigIntではない オブジェクトであり、[[BigIntData]]内部スロットを持たない。- [[Prototype]]内部スロットの値は
%Object.prototype% である。
メソッド仕様内の「このBigInt値」という表現は、抽象操作
21.2.3.1 BigInt.prototype.constructor
BigInt.prototype.constructorの初期値は
21.2.3.2 BigInt.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402国際化APIを含むECMAScript実装は、ECMA-402仕様に従ってこのメソッドを実装しなければならない。ECMA-402 APIを含まない場合は、以下の仕様による:
このメソッドは、このBigInt値を
このメソッドのオプションパラメータの意味はECMA-402仕様で定義されている。ECMA-402非対応の実装は、これらのパラメータ位置を他用途に使ってはならない。
21.2.3.3 BigInt.prototype.toString ( [ radix ] )
オプションのradixは、
このメソッドは呼び出されたとき、以下の手順を実行する:
- xを?
ThisBigIntValue (this 値)とする。 - radixが
undefined の場合、radixMVを10とする。 - それ以外の場合、radixMVを?
ToIntegerOrInfinity (radix)とする。 - radixMVが2から36の
区間 にない場合、RangeError 例外を投げる。 BigInt::toString (x, radixMV)を返す。
このメソッドはジェネリックではない;
21.2.3.4 BigInt.prototype.valueOf ( )
- ?
ThisBigIntValue (this 値)を返す。
21.2.3.4.1 ThisBigIntValue ( value )
抽象操作ThisBigIntValueは引数value（
21.2.3.5 BigInt.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
21.2.4 BigIntインスタンスのプロパティ
BigIntインスタンスは
21.3 Math オブジェクト
Math オブジェクトは以下の通りです:
- %Math%である。
"Math" プロパティの初期値はグローバルオブジェクト である。通常のオブジェクト である。- [[Prototype]]内部スロットの値は
%Object.prototype% である。 関数オブジェクト ではない。- [[Construct]]内部メソッドを持たないため、
new演算子によるコンストラクター として使用できない。 - [[Call]]内部メソッドを持たないため、関数として呼び出すことはできない。
21.3.1 Math オブジェクトの値プロパティ
21.3.1.1 Math.E
このプロパティは属性 { [[Writable]]:
21.3.1.2 Math.LN10
このプロパティは属性 { [[Writable]]:
21.3.1.3 Math.LN2
このプロパティは属性 { [[Writable]]:
21.3.1.4 Math.LOG10E
このプロパティは属性 { [[Writable]]:
Math.LOG10Eの値はMath.LN10の値のおおよそ逆数である。
21.3.1.5 Math.LOG2E
このプロパティは属性 { [[Writable]]:
Math.LOG2Eの値はMath.LN2の値のおおよそ逆数である。
21.3.1.6 Math.PI
このプロパティは属性 { [[Writable]]:
21.3.1.7 Math.SQRT1_2
このプロパティは属性 { [[Writable]]:
Math.SQRT1_2の値はMath.SQRT2の値のおおよそ逆数である。
21.3.1.8 Math.SQRT2
このプロパティは属性 { [[Writable]]:
21.3.1.9 Math [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
21.3.2 Math オブジェクトの関数プロパティ
acos、acosh、asin、asinh、atan、atanh、atan2、cbrt、cos、cosh、exp、expm1、hypot、log、log1p、log2、log10、pow、random、sin、sinh、tan、tanhの関数の挙動は、ここでは正確に定義されていないが、特定の引数値については境界例として特定の結果が要求される。その他の引数値については、これらの関数は一般的な数学関数の近似値を計算することを意図しているが、近似アルゴリズムの選択にはある程度の自由がある。一般的な意図として、実装者はそのプラットフォームのCプログラマーが利用可能な数学ライブラリをECMAScriptでも使えるようにすることが望ましい。
アルゴリズムの選択は実装に委ねられているが、推奨（標準で規定はされていない）として、fdlibm（http://www.netlib.org/fdlibm）の近似アルゴリズムを実装が利用することが挙げられる。
21.3.2.1 Math.abs ( x )
この関数はxの絶対値を返す。結果はxと同じ大きさだが符号は正となる。
呼び出されたとき、次の手順を実行する:
- nを?
ToNumber (x)とする。 - nが
NaN の場合、NaN を返す。 - nが
-0 𝔽の場合、+0 𝔽を返す。 - nが
-∞ 𝔽の場合、+∞ 𝔽を返す。 - nが
-0 𝔽より小さい場合、-nを返す。 - nを返す。
21.3.2.2 Math.acos ( x )
この関数はxの逆余弦（アークコサイン）を返す。結果はラジアンで表され、
呼び出されたとき、次の手順を実行する:
21.3.2.3 Math.acosh ( x )
この関数はxの逆双曲線余弦（アークハイパボリックコサイン）を返す。
呼び出されたとき、次の手順を実行する:
21.3.2.4 Math.asin ( x )
この関数はxの逆正弦（アークサイン）を返す。結果はラジアンで表され、
呼び出されたとき、次の手順を実行する:
21.3.2.5 Math.asinh ( x )
この関数はxの逆双曲線正弦（アークハイパボリックサイン）を返す。
呼び出されたとき、次の手順を実行する:
21.3.2.6 Math.atan ( x )
この関数はxの逆正接（アークタンジェント）を返す。結果はラジアンで表され、
呼び出されたとき、次の手順を実行する:
21.3.2.7 Math.atanh ( x )
この関数はxの逆双曲線正接（アークハイパボリックタンジェント）を返す。
呼び出されたとき、次の手順を実行する:
21.3.2.8 Math.atan2 ( y, x )
この関数は、引数yとxの商
呼び出されたとき、次の手順を実行する:
- nyを?
ToNumber (y)とする。 - nxを?
ToNumber (x)とする。 - nyが
NaN またはnxがNaN の場合、NaN を返す。 - nyが
+∞ 𝔽の場合:- nxが
+∞ 𝔽の場合、実装依存で近似したNumber値（π/4）を返す。 - nxが
-∞ 𝔽の場合、実装依存で近似したNumber値（3π/4）を返す。 - それ以外の場合、実装依存で近似したNumber値（π/2）を返す。
- nxが
- nyが
-∞ 𝔽の場合:- nxが
+∞ 𝔽の場合、実装依存で近似したNumber値（-π/4）を返す。 - nxが
-∞ 𝔽の場合、実装依存で近似したNumber値（-3π/4）を返す。 - それ以外の場合、実装依存で近似したNumber値（-π/2）を返す。
- nxが
- nyが
+0 𝔽の場合:- nx >
+0 𝔽またはnxが+0 𝔽の場合、+0 𝔽を返す。 - それ以外の場合、実装依存で近似したNumber値（π）を返す。
- nx >
- nyが
-0 𝔽の場合:- nx >
+0 𝔽またはnxが+0 𝔽の場合、-0 𝔽を返す。 - それ以外の場合、実装依存で近似したNumber値（-π）を返す。
- nx >
Assert : nyは有限 かつ+0 𝔽でも-0 𝔽でもないこと。- ny >
+0 𝔽の場合:- nxが
+∞ 𝔽の場合、+0 𝔽を返す。 - nxが
-∞ 𝔽の場合、実装依存で近似したNumber値（π）を返す。 - nxが
+0 𝔽または-0 𝔽の場合、実装依存で近似したNumber値（π/2）を返す。
- nxが
- ny
<
-0 𝔽の場合:- nxが
+∞ 𝔽の場合、-0 𝔽を返す。 - nxが
-∞ 𝔽の場合、実装依存で近似したNumber値（-π）を返す。 - nxが
+0 𝔽または-0 𝔽の場合、実装依存で近似したNumber値（-π/2）を返す。
- nxが
Assert : nxは有限 かつ+0 𝔽でも-0 𝔽でもないこと。- rを
abs (ℝ (ny) /ℝ (nx))の逆正接とする。 - nx
<
-0 𝔽の場合:- ny >
+0 𝔽の場合、rをπ - rとする。 - それ以外の場合、rを-π + rとする。
- ny >
- それ以外の場合:
- ny
<
-0 𝔽の場合、rを-rとする。
- ny
<
- 実装依存で近似した
Number値 （r）を返す。
21.3.2.9 Math.cbrt ( x )
この関数はxの立方根を返す。
呼び出されたとき、次の手順を実行する:
21.3.2.10 Math.ceil ( x )
この関数はx以上で最も小さい（-∞に最も近い）
呼び出されたとき、次の手順を実行する:
Math.ceil(x)の値は-Math.floor(-x)と同じである。
21.3.2.11 Math.clz32 ( x )
この関数は呼び出されたとき、以下の手順を実行する:
nが
21.3.2.12 Math.cos ( x )
この関数はxの余弦（コサイン）を返す。引数はラジアンで表される。
呼び出されたとき、次の手順を実行する:
21.3.2.13 Math.cosh ( x )
この関数はxの双曲線余弦（ハイパボリックコサイン）を返す。
呼び出されたとき、次の手順を実行する:
Math.cosh(x)の値は(Math.exp(x) + Math.exp(-x)) / 2と同じである。
21.3.2.14 Math.exp ( x )
この関数はxの指数関数（自然対数の底eのx乗）を返す。
呼び出されたとき、次の手順を実行する:
21.3.2.15 Math.expm1 ( x )
この関数はxの指数関数（自然対数の底eのx乗）から1を引いた値を返す。値が0に近いときも正確に計算されるよう工夫されている。
呼び出されたとき、次の手順を実行する:
21.3.2.16 Math.floor ( x )
この関数はx以下で最も大きい（+∞に最も近い）
呼び出されたとき、次の手順を実行する:
Math.floor(x)の値は-Math.ceil(-x)と同じである。
21.3.2.17 Math.fround ( x )
この関数は呼び出されたとき、以下の手順を実行する:
- nを?
ToNumber (x)とする。 - nが
NaN の場合、NaN を返す。 - nが
+0 𝔽、-0 𝔽、+∞ 𝔽、-∞ 𝔽のいずれかの場合、nを返す。 - n32をnを
IEEE 754-2019 binary32形式にroundTiesToEvenモードで変換した結果とする。 - n64をn32を
IEEE 754-2019 binary64形式に変換した結果とする。 - n64に対応するECMAScript Number値を返す。
21.3.2.18 Math.f16round ( x )
この関数は呼び出されたとき、以下の手順を実行する:
- nを?
ToNumber (x)とする。 - nが
NaN の場合、NaN を返す。 - nが
+0 𝔽、-0 𝔽、+∞ 𝔽、-∞ 𝔽のいずれかの場合、nを返す。 - n16をnを
IEEE 754-2019 binary16形式にroundTiesToEvenモードで変換した結果とする。 - n64をn16を
IEEE 754-2019 binary64形式に変換した結果とする。 - n64に対応するECMAScript Number値を返す。
この操作はbinary32にキャストしてからbinary16にキャストするのとは異なる（ダブルラウンディングの可能性があるため）。例: k =
全てのプラットフォームがbinary64からbinary16へのキャストをネイティブでサポートしているわけではない。MITライセンスのhalfライブラリなど様々なライブラリが利用できる。あるいは、まずbinary64からbinary32へroundTiesToEvenでキャストし、その結果が誤ったダブルラウンディングに繋がるかどうかを確認することもできる。該当する場合はbinary32値の仮数部を調整して、初回キャストがroundTiesToOddで生じた値になるようにし、調整後の値をbinary16へroundTiesToEvenキャストすれば正しい値になる。
21.3.2.19 Math.hypot ( ...args )
引数が0個以上与えられた場合、この関数はそれらの引数の2乗和の平方根を返す。
呼び出されたとき、次の手順を実行する:
- coercedを新しい空の
List とする。 - argsの各要素argについて:
- nを?
ToNumber (arg)とする。 - nをcoercedに追加する。
- nを?
- coercedの各要素numberについて:
- numberが
+∞ 𝔽または-∞ 𝔽の場合、+∞ 𝔽を返す。
- numberが
- onlyZeroを
true とする。 - coercedの各要素numberについて:
- numberが
NaN の場合、NaN を返す。 - numberが
+0 𝔽でも-0 𝔽でもない場合、onlyZeroをfalse に設定する。
- numberが
- onlyZeroが
true の場合、+0 𝔽を返す。 - 実装依存で近似した
Number値 （coercedの各要素の数学的値 の2乗和の平方根）を返す。
この関数の
2個以上の引数で呼び出された場合、オーバーフローやアンダーフローによる精度損失を避けるよう実装で注意すべきである。
21.3.2.20 Math.imul ( x, y )
この関数は呼び出されたとき、以下の手順を実行する:
21.3.2.21 Math.log ( x )
この関数はxの自然対数（常用対数の底eを使った対数）を返す。
呼び出されたとき、次の手順を実行する:
21.3.2.22 Math.log1p ( x )
この関数は1+xの自然対数（常用対数の底eを使った対数）を返す。値が0に近いときも正確に計算されるよう工夫されている。
呼び出されたとき、次の手順を実行する:
21.3.2.23 Math.log10 ( x )
この関数はxの常用対数（底10の対数）を返す。
呼び出されたとき、次の手順を実行する:
21.3.2.24 Math.log2 ( x )
この関数はxの底2対数を返す。
呼び出されたとき、次の手順を実行する:
21.3.2.25 Math.max ( ...args )
引数が0個以上与えられた場合、この関数は各引数に
呼び出されたとき、次の手順を実行する:
最大値を決定する値の比較は
この関数の
21.3.2.26 Math.min ( ...args )
引数が0個以上与えられた場合、この関数は各引数に
呼び出されたとき、次の手順を実行する:
最小値を決定する値の比較は
この関数の
21.3.2.27 Math.pow ( base, exponent )
この関数は呼び出されたとき、以下の手順を実行する:
- baseを?
ToNumber (base)に設定する。 - exponentを?
ToNumber (exponent)に設定する。 Number::exponentiate (base, exponent)を返す。
21.3.2.28 Math.random ( )
この関数は正の符号を持ち、
異なるMath.random関数は、連続呼び出しにより異なる値列を返さなければならない。
21.3.2.29 Math.round ( x )
この関数はxに最も近い整数のNumber値を返す。2つの
呼び出されたとき、次の手順を実行する:
Math.round(3.5)は4を返し、Math.round(-3.5)は-3を返す。
Math.round(x)の値は常にMath.floor(x + 0.5)と同じとは限らない。xがxがMath.round(x)はMath.floor(x + 0.5)はMath.round(x)はx + 0.5の内部丸めの影響によりMath.floor(x + 0.5)と値が異なる場合もある。
21.3.2.30 Math.sign ( x )
この関数はxの符号（正・負・ゼロ）を返す。
呼び出されたとき、次の手順を実行する:
- nを?
ToNumber (x)とする。 - nが
NaN 、+0 𝔽、-0 𝔽のいずれかの場合、nを返す。 - n
<
-0 𝔽の場合、-1 𝔽を返す。 1 𝔽を返す。
21.3.2.31 Math.sin ( x )
この関数はxの正弦（サイン）を返す。引数はラジアンで表される。
呼び出されたとき、次の手順を実行する:
21.3.2.32 Math.sinh ( x )
この関数はxの双曲線正弦（ハイパボリックサイン）を返す。
呼び出されたとき、次の手順を実行する:
Math.sinh(x)の値は(Math.exp(x) - Math.exp(-x)) / 2と同じである。
21.3.2.33 Math.sqrt ( x )
この関数はxの平方根を返す。
呼び出されたとき、次の手順を実行する:
21.3.2.34 Math.tan ( x )
この関数はxの正接（タンジェント）を返す。引数はラジアンで表される。
呼び出されたとき、次の手順を実行する:
21.3.2.35 Math.tanh ( x )
この関数はxの双曲線正接（ハイパボリックタンジェント）を返す。
呼び出されたとき、次の手順を実行する:
Math.tanh(x)の値は(Math.exp(x) - Math.exp(-x)) / (Math.exp(x) + Math.exp(-x))と同じである。
21.3.2.36 Math.trunc ( x )
この関数は数値xの整数部分（小数点以下を切り捨てた値）を返す。xがすでに整数なら結果はx。
呼び出されたとき、次の手順を実行する:
21.4 Date オブジェクト
21.4.1 Date オブジェクトの概要と抽象操作の定義
以下の
21.4.1.1 時刻値と時刻範囲
ECMAScriptの時刻測定はPOSIXの時刻測定と類似しており、特に暦は先行グレゴリオ暦、UTCの1970年1月1日午前0時をエポックとし、1日は正確に86,400秒（各秒は1000ミリ秒）と定義される。
ECMAScriptの時刻値は
時刻値はUTCのうるう秒を考慮しない―正のうるう秒内を表す時刻値は存在せず、負のうるう秒でUTCタイムラインから除外された瞬間を表す時刻値が存在する。ただし、時刻値の定義により、うるう秒の境界以外ではUTCと部分的に一致し、差異はうるう秒の外側ではゼロとなる。
Number型は-9,007,199,254,740,992から9,007,199,254,740,992までのすべての
1970年1月1日午前0時UTCの正確な瞬間は、時刻値
先行グレゴリオ暦では、うるう年は4で割り切れ、かつ400で割り切れるか100で割り切れない年である。
先行グレゴリオ暦の400年周期には97回のうるう年があり、平均1年は365.2425日（31,556,952,000ミリ秒）となる。Number型でミリ秒精度で正確に表現できる最大範囲は、1970年から約-285,426年から+285,426年である。本節で規定される時刻値の範囲は、1970年から約-273,790年から+273,790年である。
21.4.1.2 時刻関連の定数
これらの定数は、以降の節のアルゴリズムで参照される。
21.4.1.3 Day ( t )
抽象操作Dayは引数t（
21.4.1.4 TimeWithinDay ( t )
抽象操作TimeWithinDayは引数t（
21.4.1.5 DaysInYear ( y )
抽象操作DaysInYearは引数y（
21.4.1.6 DayFromYear ( y )
抽象操作DayFromYearは引数y（
- ryを
ℝ (y)とする。 - 注:
以下の手順では、numYears1、numYears4、numYears100、およびnumYears400は、
エポック から年yの開始までに1, 4, 100, 400で割り切れる年数を表す。年yがエポックより前の場合は負の数となる。 - numYears1を(ry - 1970)とする。
- numYears4を
floor ((ry - 1969) / 4)とする。 - numYears100を
floor ((ry - 1901) / 100)とする。 - numYears400を
floor ((ry - 1601) / 400)とする。 𝔽 (365 × numYears1 + numYears4 - numYears100 + numYears400)を返す。
21.4.1.7 TimeFromYear ( y )
抽象操作TimeFromYearは引数y（
msPerDay ×DayFromYear (y)を返す。
21.4.1.8 YearFromTime ( t )
抽象操作YearFromTimeは引数t（
- +∞に最も近い
整数Number yで、TimeFromYear (y) ≤ tとなる最大のyを返す。
21.4.1.9 DayWithinYear ( t )
抽象操作DayWithinYearは引数t（
Day (t) -DayFromYear (YearFromTime (t))を返す。
21.4.1.10 InLeapYear ( t )
抽象操作InLeapYearは引数t（
DaysInYear (YearFromTime (t))が366 𝔽なら1 𝔽を返し、そうでなければ+0 𝔽を返す。
21.4.1.11 MonthFromTime ( t )
抽象操作MonthFromTimeは、引数t（
- inLeapYearを
InLeapYear (t)とする。 - dayWithinYearを
DayWithinYear (t)とする。 - dayWithinYear
<
31 𝔽 の場合、+0 𝔽を返す。 - dayWithinYear
<
59 𝔽 + inLeapYear の場合、1 𝔽を返す。 - dayWithinYear
<
90 𝔽 + inLeapYear の場合、2 𝔽を返す。 - dayWithinYear
<
120 𝔽 + inLeapYear の場合、3 𝔽を返す。 - dayWithinYear
<
151 𝔽 + inLeapYear の場合、4 𝔽を返す。 - dayWithinYear
<
181 𝔽 + inLeapYear の場合、5 𝔽を返す。 - dayWithinYear
<
212 𝔽 + inLeapYear の場合、6 𝔽を返す。 - dayWithinYear
<
243 𝔽 + inLeapYear の場合、7 𝔽を返す。 - dayWithinYear
<
273 𝔽 + inLeapYear の場合、8 𝔽を返す。 - dayWithinYear
<
304 𝔽 + inLeapYear の場合、9 𝔽を返す。 - dayWithinYear
<
334 𝔽 + inLeapYear の場合、10 𝔽を返す。 Assert : dayWithinYear <365 𝔽 + inLeapYear。11 𝔽を返す。
21.4.1.12 DateFromTime ( t )
抽象操作DateFromTimeは、引数t（
- inLeapYearを
InLeapYear (t)とする。 - dayWithinYearを
DayWithinYear (t)とする。 - monthを
MonthFromTime (t)とする。 - monthが
+0 𝔽の場合、dayWithinYear +1 𝔽を返す。 - monthが
1 𝔽の場合、dayWithinYear -30 𝔽を返す。 - monthが
2 𝔽の場合、dayWithinYear -58 𝔽 - inLeapYearを返す。 - monthが
3 𝔽の場合、dayWithinYear -89 𝔽 - inLeapYearを返す。 - monthが
4 𝔽の場合、dayWithinYear -119 𝔽 - inLeapYearを返す。 - monthが
5 𝔽の場合、dayWithinYear -150 𝔽 - inLeapYearを返す。 - monthが
6 𝔽の場合、dayWithinYear -180 𝔽 - inLeapYearを返す。 - monthが
7 𝔽の場合、dayWithinYear -211 𝔽 - inLeapYearを返す。 - monthが
8 𝔽の場合、dayWithinYear -242 𝔽 - inLeapYearを返す。 - monthが
9 𝔽の場合、dayWithinYear -272 𝔽 - inLeapYearを返す。 - monthが
10 𝔽の場合、dayWithinYear -303 𝔽 - inLeapYearを返す。 Assert : monthは11 𝔽である。- dayWithinYear -
333 𝔽 - inLeapYearを返す。
21.4.1.13 WeekDay ( t )
抽象操作WeekDayは、引数t（
21.4.1.14 HourFromTime ( t )
抽象操作HourFromTimeは、引数t（
21.4.1.15 MinFromTime ( t )
抽象操作MinFromTimeは、引数t（
𝔽 (floor (ℝ (t /msPerMinute ))modulo MinutesPerHour )を返す。
21.4.1.16 SecFromTime ( t )
抽象操作SecFromTimeは、引数t（
𝔽 (floor (ℝ (t /msPerSecond ))modulo SecondsPerMinute )を返す。
21.4.1.17 msFromTime ( t )
抽象操作msFromTimeは、引数t（
𝔽 (ℝ (t)modulo ℝ (msPerSecond ))を返す。
21.4.1.18 GetUTCEpochNanoseconds ( year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
抽象操作 GetUTCEpochNanoseconds は引数 year（
21.4.1.19 タイムゾーン識別子
ECMAScript のタイムゾーンは、タイムゾーン識別子によって表される。これは、
主タイムゾーン識別子は、利用可能な名前付きタイムゾーンの推奨識別子である。 非主タイムゾーン識別子は、主タイムゾーン識別子ではない利用可能な名前付きタイムゾーンの識別子である。 利用可能な名前付きタイムゾーン識別子は、主タイムゾーン識別子または非主タイムゾーン識別子のいずれかである。 各利用可能な名前付きタイムゾーン識別子は、正確に 1 つの利用可能な名前付きタイムゾーンと関連付けられる。 各利用可能な名前付きタイムゾーンは、正確に 1 つの主タイムゾーン識別子と 0 個以上の非主タイムゾーン識別子と関連付けられる。
ECMAScript の実装は、識別子
ECMA-402 Internationalization API 仕様に記載されたタイムゾーンの要件に従う実装は、タイムゾーン対応と呼ばれる。
タイムゾーン対応の実装は、IANA タイムゾーンデータベースの Zone 名および Link 名に対応する利用可能な名前付きタイムゾーンのみをサポートしなければならない。
タイムゾーン対応の実装では、主タイムゾーン識別子は Zone 名、非主タイムゾーン識別子は Link 名である。ただし、
21.4.1.20 GetNamedTimeZoneEpochNanoseconds ( timeZoneIdentifier, year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
入力が負のタイムゾーン遷移（例えば夏時間終了やタイムゾーンオフセット減少による規則変更）により 1 つのローカルタイムが複数回現れる場合、返される
GetNamedTimeZoneEpochNanoseconds のデフォルト実装は、どのタイムゾーンにもローカルな政治的規則を含まない ECMAScript 実装向けに、呼び出し時に以下の手順を実行する:
アサート : timeZoneIdentifier は"UTC" である。- epochNanoseconds を
GetUTCEpochNanoseconds (year, month, day, hour, minute, second, millisecond, microsecond, nanosecond) とする。 - « epochNanoseconds » を返す。
2017 年 11 月 5 日 1:30 AM の America/New_York は 2
回繰り返されるため、GetNamedTimeZoneEpochNanoseconds(
2017 年 3 月 12 日 2:30 AM の America/New_York
は存在しないため、GetNamedTimeZoneEpochNanoseconds(
21.4.1.21 GetNamedTimeZoneOffsetNanoseconds ( timeZoneIdentifier, epochNanoseconds )
返される
GetNamedTimeZoneOffsetNanoseconds のデフォルト実装は、どのタイムゾーンにもローカルな政治的規則を含まない ECMAScript 実装向けに、呼び出し時に以下の手順を実行する:
アサート : timeZoneIdentifier は"UTC" である。- 0 を返す。
タイムゾーンオフセット値は正または負になる場合がある。
21.4.1.22 タイムゾーン識別子レコード
タイムゾーン識別子レコードは、
タイムゾーン識別子レコードは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Identifier]] | 文字列 | 実装がサポートする |
| [[PrimaryIdentifier]] | 文字列 | [[Identifier]] が解決される |
[[Identifier]] が
21.4.1.23 AvailableNamedTimeZoneIdentifiers ( )
- 実装がいずれのタイムゾーンにもローカルな政治的規則を含まない場合、
タイムゾーン識別子レコード { [[Identifier]]:"UTC" , [[PrimaryIdentifier]]:"UTC" } を返す。
- identifiers を、
リスト （一意な利用可能な名前付きタイムゾーン識別子 のリスト）で、辞書順コード単位順序 でソートする。 - result を新しい空の
リスト とする。 - identifiers の各要素 identifier について、
- primary を identifier とする。
- identifier がこの実装における
非主タイムゾーン識別子 であり、かつ identifier が"UTC" でない場合、- primary を identifier に関連付けられた
主タイムゾーン識別子 に設定する。 - 注: 実装によっては、identifier を反復的に解決して
主タイムゾーン識別子 を取得する必要がある場合がある。
- primary を identifier に関連付けられた
- record を
タイムゾーン識別子レコード { [[Identifier]]: identifier, [[PrimaryIdentifier]]: primary } とする。 - record を result に追加する。
アサート : result がタイムゾーン識別子レコード r を含み、r.[[Identifier]] が"UTC" かつ r.[[PrimaryIdentifier]] が"UTC" である。- result を返す。
21.4.1.24 SystemTimeZoneIdentifier ( )
- 実装が UTC タイムゾーンのみをサポートする場合は
"UTC" を返す。 - systemTimeZoneString を、
ホスト環境 の現在のタイムゾーンを表す文字列（主タイムゾーン識別子 またはオフセットタイムゾーン識別子 ）とする。 - systemTimeZoneString を返す。
Date オブジェクトのメソッドで一般的に提供される機能水準を確保するため、SystemTimeZoneIdentifier は
例えば、
21.4.1.25 LocalTime ( t )
抽象操作 LocalTime は、引数 t（
- systemTimeZoneIdentifier を
SystemTimeZoneIdentifier () とする。 - もし
IsTimeZoneOffsetString (systemTimeZoneIdentifier) がtrue ならば、- offsetNs を
ParseTimeZoneOffsetString (systemTimeZoneIdentifier) とする。
- offsetNs を
- それ以外の場合、
- offsetNs を
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier,ℤ (ℝ (t) × 106)) とする。
- offsetNs を
- offsetMs を
truncate (offsetNs / 106) とする。 - t +
𝔽 (offsetMs) を返す。
ローカル時間 t の政治的規則が実装内で利用できない場合、結果は t となる。なぜなら
21.4.1.26 UTC ( t )
抽象操作 UTC は引数 t（Number型）を受け取り、
- t が
有限 でない場合、NaN を返す。 - systemTimeZoneIdentifier を
SystemTimeZoneIdentifier () とする。 IsTimeZoneOffsetString (systemTimeZoneIdentifier) がtrue の場合、- offsetNs を
ParseTimeZoneOffsetString (systemTimeZoneIdentifier) とする。
- offsetNs を
- それ以外の場合、
- possibleInstants を
GetNamedTimeZoneEpochNanoseconds (systemTimeZoneIdentifier,ℝ (YearFromTime (t)),ℝ (MonthFromTime (t)) + 1,ℝ (DateFromTime (t)),ℝ (HourFromTime (t)),ℝ (MinFromTime (t)),ℝ (SecFromTime (t)),ℝ (msFromTime (t)), 0, 0). - 注: 以下の手順は、t が負のタイムゾーン遷移（夏時間終了やタイムゾーンオフセット減少による規則変更）で複数回繰り返されるローカル時間、または正のタイムゾーン遷移（夏時間開始やタイムゾーンオフセット増加による規則変更）で飛ばされたローカル時間を表す場合、t を遷移前のタイムゾーンオフセットで解釈することを保証する。
- possibleInstants が空でない場合、
- disambiguatedInstant を possibleInstants[0] とする。
- それ以外の場合、
- 注: t は正のタイムゾーン遷移（夏時間開始や UTC オフセット増加による規則変更）で飛ばされたローカル時間を表す。
- possibleInstantsBefore を
GetNamedTimeZoneEpochNanoseconds (systemTimeZoneIdentifier,ℝ (YearFromTime (tBefore)),ℝ (MonthFromTime (tBefore)) + 1,ℝ (DateFromTime (tBefore)),ℝ (HourFromTime (tBefore)),ℝ (MinFromTime (tBefore)),ℝ (SecFromTime (tBefore)),ℝ (msFromTime (tBefore)), 0, 0), ただし tBefore は possibleInstantsBefore が空でない最大の整数値 Number < t（つまり tBefore は遷移直前の最後のローカル時間）である。 - disambiguatedInstant を possibleInstantsBefore の最後の要素とする。
- offsetNs を
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier, disambiguatedInstant) とする。
- possibleInstants を
- offsetMs を
truncate (offsetNs / 106) とする。 - t -
𝔽 (offsetMs) を返す。
入力 t は名目上
ローカル時間 t の政治的規則が実装内で利用できない場合、結果は t となる。なぜなら
2017年11月5日 1:30 AM の America/New_York は 2 回繰り返される（秋の巻き戻し）が、1:30 AM UTC-05 ではなく 1:30
AM UTC-04 として解釈されなければならない。
UTC(
2017年3月12日 2:30 AM の America/New_York は存在しないが、2:30 AM UTC-05（3:30 AM UTC-04
と同等）として解釈されなければならない。
UTC(
21.4.1.27 MakeTime ( hour, min, sec, ms )
抽象操作 MakeTime は、引数 hour（Number型）、min（Number型）、sec（Number型）、ms（Number型）を受け取り、Number型を返す。これはミリ秒数を計算する。呼び出されたとき、以下の手順を実行する:
- hour が
有限 でない、min が有限 でない、 sec が有限 でない、または ms が有限 でない場合、NaN を返す。 - h を
𝔽 (!ToIntegerOrInfinity (hour)) とする。 - m を
𝔽 (!ToIntegerOrInfinity (min)) とする。 - s を
𝔽 (!ToIntegerOrInfinity (sec)) とする。 - milli を
𝔽 (!ToIntegerOrInfinity (ms)) とする。 - 次を返す: ((h ×
msPerHour + m ×msPerMinute ) + s ×msPerSecond ) + milli。
MakeTime の算術演算は浮動小数点演算であり、結合則は成り立たないため、演算は正しい順序で行う必要がある。
21.4.1.28 MakeDay ( year, month, date )
抽象操作 MakeDay は、引数 year（Number型）、month（Number型）、date（Number型）を受け取り、Number型を返す。これは日数を計算する。呼び出されたとき、以下の手順を実行する:
- year が
有限 でない、month が有限 でない、 date が有限 でない場合、NaN を返す。 - y を
𝔽 (!ToIntegerOrInfinity (year)) とする。 - m を
𝔽 (!ToIntegerOrInfinity (month)) とする。 - dt を
𝔽 (!ToIntegerOrInfinity (date)) とする。 - ym を y +
𝔽 (floor (ℝ (m) / 12)) とする。 - ym が
有限 でない場合、NaN を返す。 - mn を
𝔽 (ℝ (m)modulo 12) とする。 - 有限な
時間値 t を見つける。YearFromTime (t) が ym であり、MonthFromTime (t) が mn であり、DateFromTime (t) が1 𝔽 である。ただしこれが不可能（引数が範囲外）ならNaN を返す。 Day (t) + dt -1 𝔽 を返す。
21.4.1.29 MakeDate ( day, time )
抽象操作 MakeDate は、引数 day（Number型）と time（Number型）を受け取り、Number型を返す。これはミリ秒数を計算する。呼び出されたとき、以下の手順を実行する:
21.4.1.30 MakeFullYear ( year )
抽象操作 MakeFullYear は引数 year（Number型）を受け取り、
- year が
NaN の場合、NaN を返す。 - truncated を !
ToIntegerOrInfinity (year) とする。 - truncated が
0 から 99 の包含区間 にある場合、1900 𝔽 +𝔽 (truncated) を返す。 𝔽 (truncated) を返す。
21.4.1.31 TimeClip ( time )
抽象操作 TimeClip は引数 time（Number型）を受け取り、Number型を返す。これはミリ秒数を計算する。呼び出されたとき、以下の手順を実行する:
- time が
有限 でない場合、NaN を返す。 abs (ℝ (time)) > 8.64 × 1015 の場合、NaN を返す。𝔽 (!ToIntegerOrInfinity (time)) を返す。
21.4.1.32 日時文字列フォーマット
ECMAScript は、ISO 8601 カレンダー日付拡張形式の簡略化に基づく日付時刻交換フォーマットを定義する。フォーマットは以下の通り:
YYYY-MM-DDTHH:mm:ss.sssZ
各要素の説明:
YYYY
|
補助グレゴリオ暦の年。4 桁の 0000 〜 9999、または |
-
|
|
MM
|
年の月。2 桁の 01（1月）〜12（12月）。 |
DD
|
月の日。2 桁の 01〜31。 |
T
|
|
HH
|
前日の深夜から経過した完全な時の数。2 桁の 00〜24。 |
:
|
|
mm
|
時の開始から経過した完全な分の数。2 桁の 00〜59。 |
ss
|
分の開始から経過した完全な秒の数。2 桁の 00〜59。 |
.
|
|
sss
|
秒の開始から経過した完全なミリ秒の数。3 桁。 |
Z
|
UTC オフセット表現。HH:mm（ |
このフォーマットには日付のみの形式も含む:
YYYY
YYYY-MM
YYYY-MM-DD
また、上記の日付のみ形式に続けて、以下の時刻形式（オプションで UTC オフセット表現を付加）をつなげた「日時」形式も含む:
THH:mm
THH:mm:ss
THH:mm:ss.sss
範囲外や非準拠の要素を含む文字列は、このフォーマットの有効なインスタンスではない。
各日付は深夜に始まり深夜に終わるため、2 つの 00:00 および 24:00 の表記が 1 つの日付に関連付けられる
2 つの深夜を区別するために利用できる。すなわち、以下の 2 つの表記は全く同じ時点を示す: 1995-02-04T24:00 と
1995-02-05T00:00。この後者を「カレンダー日の終わり」と解釈するのは ISO 8601
と一致するが、同仕様は時刻区間の記述にのみ許可し、単一の時点の表現では認めていない。
CET, EST などの市民タイムゾーン略語を規定する国際標準は存在せず、同じ略語が異なるタイムゾーンに使われることもあるため、ISO 8601 と本フォーマットはタイムゾーンオフセットの数値表現を規定している。
21.4.1.32.1 拡張年
約 273,790 年を前後にカバーするDate.parse
拡張年付き日時値の例:
| -271821-04-20T00:00:00Z | 紀元前 271822 年 |
| -000001-01-01T00:00:00Z | 紀元前 2 年 |
| +000000-01-01T00:00:00Z | 紀元前 1 年 |
| +000001-01-01T00:00:00Z | 西暦 1 年 |
| +001970-01-01T00:00:00Z | 西暦 1970 年 |
| +002009-12-15T00:00:00Z | 西暦 2009 年 |
| +275760-09-13T00:00:00Z | 西暦 275760 年 |
21.4.1.33 タイムゾーンオフセット文字列フォーマット
ECMAScript は、ISO 8601 に由来する UTC オフセットの文字列交換フォーマットを定義する。 フォーマットは以下の文法で記述される。
構文
21.4.1.33.1 IsTimeZoneOffsetString ( offsetString )
抽象操作 IsTimeZoneOffsetString は引数 offsetString（文字列）を受け取り、Boolean を返す。返値は
offsetString が
21.4.1.33.2 ParseTimeZoneOffsetString ( offsetString )
抽象操作 ParseTimeZoneOffsetString は引数 offsetString（文字列）を受け取り、
- parseResult を
ParseText (offsetString,UTCOffset ) とする。 アサート : parseResult はエラーのリスト ではない。アサート : parseResult はASCIISign 構文ノード を含む。- parsedSign を
対応する元のテキスト （ASCIISign 構文ノード ）とする。 - parsedSign がコードポイント U+002D（ハイフン）なら
- sign を -1 とする。
- それ以外の場合
- sign を 1 とする。
- 注: 以下で使用される
StringToNumber は、解析値が十分短い数字文字列であるため、精度を失うことはない。 アサート : parseResult はHour 構文ノード を含む。- parsedHours を
対応する元のテキスト （Hour 構文ノード ）とする。 - hours を
ℝ (StringToNumber (CodePointsToString (parsedHours))) とする。 - parseResult が
MinuteSecond 構文ノード を含まない場合- minutes を 0 とする。
- それ以外の場合
- parsedMinutes を
対応する元のテキスト （最初のMinuteSecond 構文ノード ）とする。 - minutes を
ℝ (StringToNumber (CodePointsToString (parsedMinutes))) とする。
- parsedMinutes を
- parseResult が 2 つの
MinuteSecond 構文ノード を含まない場合- seconds を 0 とする。
- それ以外の場合
- parsedSeconds を
対応する元のテキスト （2 番目のMinuteSecond 構文ノード ）とする。 - seconds を
ℝ (StringToNumber (CodePointsToString (parsedSeconds))) とする。
- parsedSeconds を
- parseResult が
TemporalDecimalFraction 構文ノード を含まない場合- nanoseconds を 0 とする。
- それ以外の場合
- parsedFraction を
対応する元のテキスト （TemporalDecimalFraction 構文ノード ）とする。 - fraction を
文字列連結 でCodePointsToString (parsedFraction) と"000000000" を連結したものとする。 - nanosecondsString を
substring の fraction の 1 から 10 までとする。 - nanoseconds を
ℝ (StringToNumber (nanosecondsString)) とする。
- parsedFraction を
- sign × (((hours × 60 + minutes) × 60 + seconds) × 109 + nanoseconds) を返す。
21.4.2 Date コンストラクター
Date
- %Date% である。
グローバルオブジェクト の"Date" プロパティの初期値である。コンストラクター として呼び出されたとき、新しい Date を作成・初期化する。コンストラクター としてではなく関数として呼び出されたとき、現在時刻（UTC）を表す文字列を返す。- 引数の数や型によって動作が異なる関数である。
- クラス定義の
extends節の値として使用できる。指定された Date の動作を継承するサブクラスコンストラクター は、superで Dateコンストラクター を呼び出し、サブクラスインスタンスの [[DateValue]] 内部スロットを作成・初期化しなければならない。
21.4.2.1 Date ( ...values )
この関数は呼び出されたとき、以下の手順を実行する:
- NewTarget が
undefined の場合、- now を現在時刻を特定する
時間値 （UTC）とする。 ToDateString (now) を返す。
- now を現在時刻を特定する
- numberOfArgs を values の要素数とする。
- numberOfArgs = 0 の場合、
- dv を現在時刻を特定する
時間値 （UTC）とする。
- dv を現在時刻を特定する
- numberOfArgs = 1 の場合、
- それ以外の場合、
アサート : numberOfArgs ≥ 2。- y を ?
ToNumber (values[0]) とする。 - m を ?
ToNumber (values[1]) とする。 - numberOfArgs > 2 なら dt を ?
ToNumber (values[2]) とし、それ以外は1 𝔽 とする。 - numberOfArgs > 3 なら h を ?
ToNumber (values[3]) とし、それ以外は+0 𝔽 とする。 - numberOfArgs > 4 なら min を ?
ToNumber (values[4]) とし、それ以外は+0 𝔽 とする。 - numberOfArgs > 5 なら s を ?
ToNumber (values[5]) とし、それ以外は+0 𝔽 とする。 - numberOfArgs > 6 なら milli を ?
ToNumber (values[6]) とし、それ以外は+0 𝔽 とする。 - yr を
MakeFullYear (y) とする。 - finalDate を
MakeDate (MakeDay (yr, m, dt),MakeTime (h, min, s, milli)) とする。 - dv を
TimeClip (UTC (finalDate)) とする。
- O を ?
OrdinaryCreateFromConstructor (NewTarget,"%Date.prototype%" , « [[DateValue]] ») とする。 - O.[[DateValue]] に dv を設定する。
- O を返す。
21.4.3 Date コンストラクターのプロパティ
Date
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% である。 "length" プロパティを持ち、その値は7 𝔽 である。- 次のプロパティを持つ：
21.4.3.1 Date.now ( )
この関数は、呼び出し時の UTC の日時を示す
21.4.3.2 Date.parse ( string )
この関数は引数に
文字列が MM や DD がない場合は
HH、mm、ss がない場合は
sss がない場合は
ある Date のミリ秒値がゼロで、実装のすべてのプロパティが初期値の場合、以下の式はいずれも同じ数値を返すべきである：
x.valueOf()
Date.parse(x.toString())
Date.parse(x.toUTCString())
Date.parse(x.toISOString())ただし、以下の式：
Date.parse(x.toLocaleString())は、先の3つの式と同じ値を返す必要はなく、一般にこの関数が Date Time String Format（toString や toUTCString メソッドで生成できない文字列を与えられた場合に返す値は
21.4.3.3 Date.prototype
Date.prototype の初期値は
このプロパティの属性は { [[Writable]]:
21.4.3.4 Date.UTC ( year [ , month [ , date [ , hours [ , minutes [ , seconds [ , ms ] ] ] ] ] ] )
この関数は呼び出されたとき、以下の手順を実行する:
- y を ?
ToNumber (year) とする。 - month が与えられていれば m を ?
ToNumber (month) とし、なければ+0 𝔽 とする。 - date が与えられていれば dt を ?
ToNumber (date) とし、なければ1 𝔽 とする。 - hours が与えられていれば h を ?
ToNumber (hours) とし、なければ+0 𝔽 とする。 - minutes が与えられていれば min を ?
ToNumber (minutes) とし、なければ+0 𝔽 とする。 - seconds が与えられていれば s を ?
ToNumber (seconds) とし、なければ+0 𝔽 とする。 - ms が与えられていれば milli を ?
ToNumber (ms) とし、なければ+0 𝔽 とする。 - yr を
MakeFullYear (y) とする。 - 次を返す:
TimeClip (MakeDate (MakeDay (yr, m, dt),MakeTime (h, min, s, milli))).
この関数の
21.4.4 Date プロトタイプオブジェクトのプロパティ
Date プロトタイプオブジェクト：
- %Date.prototype% である。
通常のオブジェクト である。- Date インスタンスではなく、[[DateValue]] 内部スロットは持たない。
- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% である。
特に明示されない限り、以下で定義される Date プロトタイプオブジェクトのメソッドはジェネリックではなく、渡される
21.4.4.1 Date.prototype.constructor
Date.prototype.constructor の初期値は
21.4.4.2 Date.prototype.getDate ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 DateFromTime (LocalTime (t)) を返す。
21.4.4.3 Date.prototype.getDay ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 WeekDay (LocalTime (t)) を返す。
21.4.4.4 Date.prototype.getFullYear ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 YearFromTime (LocalTime (t)) を返す。
21.4.4.5 Date.prototype.getHours ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 HourFromTime (LocalTime (t)) を返す。
21.4.4.6 Date.prototype.getMilliseconds ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 msFromTime (LocalTime (t)) を返す。
21.4.4.7 Date.prototype.getMinutes ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 MinFromTime (LocalTime (t)) を返す。
21.4.4.8 Date.prototype.getMonth ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 MonthFromTime (LocalTime (t)) を返す。
21.4.4.9 Date.prototype.getSeconds ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 SecFromTime (LocalTime (t)) を返す。
21.4.4.10 Date.prototype.getTime ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - dateObject.[[DateValue]] を返す。
21.4.4.11 Date.prototype.getTimezoneOffset ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 - (t -
LocalTime (t)) /msPerMinute を返す。
21.4.4.12 Date.prototype.getUTCDate ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 DateFromTime (t) を返す。
21.4.4.13 Date.prototype.getUTCDay ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 WeekDay (t) を返す。
21.4.4.14 Date.prototype.getUTCFullYear ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 YearFromTime (t) を返す。
21.4.4.15 Date.prototype.getUTCHours ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 HourFromTime (t) を返す。
21.4.4.16 Date.prototype.getUTCMilliseconds ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 msFromTime (t) を返す。
21.4.4.17 Date.prototype.getUTCMinutes ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 MinFromTime (t) を返す。
21.4.4.18 Date.prototype.getUTCMonth ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 MonthFromTime (t) を返す。
21.4.4.19 Date.prototype.getUTCSeconds ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら、NaN を返す。 SecFromTime (t) を返す。
21.4.4.20 Date.prototype.setDate ( date )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- dt を ?
ToNumber (date) とする。 - t が
NaN なら、NaN を返す。 - t を
LocalTime (t) に設定する。 - newDate を
MakeDate (MakeDay (YearFromTime (t),MonthFromTime (t), dt),TimeWithinDay (t)) とする。 - u を
TimeClip (UTC (newDate)) とする。 - dateObject.[[DateValue]] に u を設定する。
- u を返す。
21.4.4.21 Date.prototype.setFullYear ( year [ , month [ , date ] ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- y を ?
ToNumber (year) とする。 - t が
NaN なら t を+0 𝔽 に設定する。それ以外の場合は t をLocalTime (t) に設定する。 - month が指定されていなければ m を
MonthFromTime (t) に設定する。指定されていれば m を ?ToNumber (month) に設定する。 - date が指定されていなければ dt を
DateFromTime (t) に設定する。指定されていれば dt を ?ToNumber (date) に設定する。 - newDate を
MakeDate (MakeDay (y, m, dt),TimeWithinDay (t)) に設定する。 - u を
TimeClip (UTC (newDate)) に設定する。 - dateObject.[[DateValue]] に u を設定する。
- u を返す。
このメソッドの
month が指定されていない場合、このメソッドは month が getMonth()
の値で指定されたかのように動作する。date が指定されていない場合は date が
getDate() の値で指定されたかのように動作する。
21.4.4.22 Date.prototype.setHours ( hour [ , min [ , sec [ , ms ] ] ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- h を ?
ToNumber (hour) とする。 - min が指定されていれば m を ?
ToNumber (min) に設定する。 - sec が指定されていれば s を ?
ToNumber (sec) に設定する。 - ms が指定されていれば milli を ?
ToNumber (ms) に設定する。 - t が
NaN ならNaN を返す。 - t を
LocalTime (t) に設定する。 - min が指定されていなければ m を
MinFromTime (t) に設定する。 - sec が指定されていなければ s を
SecFromTime (t) に設定する。 - ms が指定されていなければ milli を
msFromTime (t) に設定する。 - date を
MakeDate (Day (t),MakeTime (h, m, s, milli)) に設定する。 - u を
TimeClip (UTC (date)) に設定する。 - dateObject.[[DateValue]] に u を設定する。
- u を返す。
このメソッドの
min が指定されていない場合、このメソッドは min が getMinutes()
の値で指定されたかのように動作する。sec が指定されていない場合は sec が
getSeconds() の値で指定されたかのように動作する。ms が指定されていない場合は ms
が getMilliseconds() の値で指定されたかのように動作する。
21.4.4.23 Date.prototype.setMilliseconds ( ms )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- ms を ?
ToNumber (ms) に設定する。 - t が
NaN ならNaN を返す。 - t を
LocalTime (t) に設定する。 - time を
MakeTime (HourFromTime (t),MinFromTime (t),SecFromTime (t), ms) に設定する。 - u を
TimeClip (UTC (MakeDate (Day (t), time))) に設定する。 - dateObject.[[DateValue]] に u を設定する。
- u を返す。
21.4.4.24 Date.prototype.setMinutes ( min [ , sec [ , ms ] ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- m を ?
ToNumber (min) に設定する。 - sec が指定されていれば s を ?
ToNumber (sec) に設定する。 - ms が指定されていれば milli を ?
ToNumber (ms) に設定する。 - t が
NaN ならNaN を返す。 - t を
LocalTime (t) に設定する。 - sec が指定されていなければ s を
SecFromTime (t) に設定する。 - ms が指定されていなければ milli を
msFromTime (t) に設定する。 - date を
MakeDate (Day (t),MakeTime (HourFromTime (t), m, s, milli)) に設定する。 - u を
TimeClip (UTC (date)) に設定する。 - dateObject.[[DateValue]] に u を設定する。
- u を返す。
このメソッドの
sec が指定されていない場合、このメソッドは sec が getSeconds()
の値で指定されたかのように動作する。ms が指定されていない場合は ms が
getMilliseconds() の値で指定されたかのように動作する。
21.4.4.25 Date.prototype.setMonth ( month [ , date ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- m を ?
ToNumber (month) に設定する。 - date が指定されていれば dt を ?
ToNumber (date) に設定する。 - t が
NaN ならNaN を返す。 - t を
LocalTime (t) に設定する。 - date が指定されていなければ dt を
DateFromTime (t) に設定する。 - newDate を
MakeDate (MakeDay (YearFromTime (t), m, dt),TimeWithinDay (t)) に設定する。 - u を
TimeClip (UTC (newDate)) に設定する。 - dateObject.[[DateValue]] に u を設定する。
- u を返す。
このメソッドの
date が指定されていない場合、このメソッドは date が getDate()
の値で指定されたかのように動作する。
21.4.4.26 Date.prototype.setSeconds ( sec [ , ms ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- s を ?
ToNumber (sec) に設定する。 - ms が指定されていれば milli を ?
ToNumber (ms) に設定する。 - t が
NaN ならNaN を返す。 - t を
LocalTime (t) に設定する。 - ms が指定されていなければ milli を
msFromTime (t) に設定する。 - date を
MakeDate (Day (t),MakeTime (HourFromTime (t),MinFromTime (t), s, milli)) に設定する。 - u を
TimeClip (UTC (date)) に設定する。 - dateObject.[[DateValue]] に u を設定する。
- u を返す。
このメソッドの
ms が指定されていない場合、このメソッドは ms が getMilliseconds()
の値で指定されたかのように動作する。
21.4.4.27 Date.prototype.setTime ( time )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を ?
ToNumber (time) に設定する。 - v を
TimeClip (t) に設定する。 - dateObject.[[DateValue]] に v を設定する。
- v を返す。
21.4.4.28 Date.prototype.setUTCDate ( date )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- dt を ?
ToNumber (date) に設定する。 - t が
NaN ならNaN を返す。 - newDate を
MakeDate (MakeDay (YearFromTime (t),MonthFromTime (t), dt),TimeWithinDay (t)) に設定する。 - v を
TimeClip (newDate) に設定する。 - dateObject.[[DateValue]] に v を設定する。
- v を返す。
21.4.4.29 Date.prototype.setUTCFullYear ( year [ , month [ , date ] ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN なら t を+0 𝔽 に設定する。 - y を ?
ToNumber (year) に設定する。 - month が指定されていなければ m を
MonthFromTime (t) に設定する。指定されていれば m を ?ToNumber (month) に設定する。 - date が指定されていなければ dt を
DateFromTime (t) に設定する。指定されていれば dt を ?ToNumber (date) に設定する。 - newDate を
MakeDate (MakeDay (y, m, dt),TimeWithinDay (t)) に設定する。 - v を
TimeClip (newDate) に設定する。 - dateObject.[[DateValue]] に v を設定する。
- v を返す。
このメソッドの
month が指定されていない場合、このメソッドは month が getUTCMonth()
の値で指定されたかのように動作する。date が指定されていない場合は date が
getUTCDate() の値で指定されたかのように動作する。
21.4.4.30 Date.prototype.setUTCHours ( hour [ , min [ , sec [ , ms ] ] ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- h を ?
ToNumber (hour) に設定する。 - min が指定されていれば m を ?
ToNumber (min) に設定する。 - sec が指定されていれば s を ?
ToNumber (sec) に設定する。 - ms が指定されていれば milli を ?
ToNumber (ms) に設定する。 - t が
NaN ならNaN を返す。 - min が指定されていなければ m を
MinFromTime (t) に設定する。 - sec が指定されていなければ s を
SecFromTime (t) に設定する。 - ms が指定されていなければ milli を
msFromTime (t) に設定する。 - date を
MakeDate (Day (t),MakeTime (h, m, s, milli)) に設定する。 - v を
TimeClip (date) に設定する。 - dateObject.[[DateValue]] に v を設定する。
- v を返す。
このメソッドの
min が指定されていない場合、このメソッドは min が getUTCMinutes()
の値で指定されたかのように動作する。sec が指定されていない場合は sec が
getUTCSeconds() の値で指定されたかのように動作する。ms が指定されていない場合は
ms が getUTCMilliseconds() の値で指定されたかのように動作する。
21.4.4.31 Date.prototype.setUTCMilliseconds ( ms )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- ms を ?
ToNumber (ms) に設定する。 - t が
NaN ならNaN を返す。 - time を
MakeTime (HourFromTime (t),MinFromTime (t),SecFromTime (t), ms) に設定する。 - v を
TimeClip (MakeDate (Day (t), time))) に設定する。 - dateObject.[[DateValue]] に v を設定する。
- v を返す。
21.4.4.32 Date.prototype.setUTCMinutes ( min [ , sec [ , ms ] ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- m を ?
ToNumber (min) に設定する。 - sec が指定されていれば s を ?
ToNumber (sec) に設定する。 - ms が指定されていれば milli を ?
ToNumber (ms) に設定する。 - t が
NaN ならNaN を返す。 - sec が指定されていなければ s を
SecFromTime (t) に設定する。 - ms が指定されていなければ milli を
msFromTime (t) に設定する。 - date を
MakeDate (Day (t),MakeTime (HourFromTime (t), m, s, milli))) に設定する。 - v を
TimeClip (date) に設定する。 - dateObject.[[DateValue]] に v を設定する。
- v を返す。
このメソッドの
sec が指定されていない場合、このメソッドは sec が getUTCSeconds()
の値で指定されたかのように動作する。ms が指定されていない場合は ms が
getUTCMilliseconds() の値で指定されたかのように動作する。
21.4.4.33 Date.prototype.setUTCMonth ( month [ , date ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- m を ?
ToNumber (month) に設定する。 - date が指定されていれば dt を ?
ToNumber (date) に設定する。 - t が
NaN ならNaN を返す。 - date が指定されていなければ dt を
DateFromTime (t) に設定する。 - newDate を
MakeDate (MakeDay (YearFromTime (t), m, dt),TimeWithinDay (t)) に設定する。 - v を
TimeClip (newDate) に設定する。 - dateObject.[[DateValue]] に v を設定する。
- v を返す。
このメソッドの
date が指定されていない場合、このメソッドは date が getUTCDate()
の値で指定されたかのように動作する。
21.4.4.34 Date.prototype.setUTCSeconds ( sec [ , ms ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- s を ?
ToNumber (sec) に設定する。 - ms が指定されていれば milli を ?
ToNumber (ms) に設定する。 - t が
NaN ならNaN を返す。 - ms が指定されていなければ milli を
msFromTime (t) に設定する。 - date を
MakeDate (Day (t),MakeTime (HourFromTime (t),MinFromTime (t), s, milli))) に設定する。 - v を
TimeClip (date) に設定する。 - dateObject.[[DateValue]] に v を設定する。
- v を返す。
このメソッドの
ms が指定されていない場合、このメソッドは ms が getUTCMilliseconds()
の値で指定されたかのように動作する。
21.4.4.35 Date.prototype.toDateString ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - tv を dateObject.[[DateValue]] とする。
- tv が
NaN なら"Invalid Date" を返す。 - t を
LocalTime (tv) に設定する。 DateString (t) を返す。
21.4.4.36 Date.prototype.toISOString ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - tv を dateObject.[[DateValue]] とする。
- tv が
NaN ならRangeError 例外をスローする。 アサート : tv は整数値 Number である。- tv が
Date Time String Format で表現できない年に対応する場合、RangeError 例外をスローする。 - tv の UTC 時間スケールにおける
Date Time String Format のすべてのフォーマット要素および UTC オフセット表現"Z" を含む文字列表現を返す。
21.4.4.37 Date.prototype.toJSON ( key )
このメソッドは JSON.stringify（
呼び出されたとき、以下の手順を実行する：
- O を ?
ToObject (this value) とする。 - tv を ?
ToPrimitive (O,number ) とする。 - tv が
Number型 であり、かつ tv が有限 でない場合、null を返す。 - ?
Invoke (O,"toISOString" ) を返す。
引数は無視される。
このメソッドは意図的にジェネリックであり、toISOString
メソッドを持つ必要がある。
21.4.4.38 Date.prototype.toLocaleDateString ( [ reserved1 [ , reserved2 ] ] )
ECMAScript 実装が ECMA-402 国際化 API を含む場合、このメソッドは ECMA-402 仕様に従って実装されなければならない。ECMA-402 API を含まない場合は、以下の仕様が使用される：
このメソッドは文字列値を返す。文字列の内容は
このメソッドのオプションパラメータの意味は ECMA-402 仕様で定義される。ECMA-402 サポートがない実装は、そのパラメータ位置を他の用途に使ってはならない。
21.4.4.39 Date.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMAScript 実装が ECMA-402 国際化 API を含む場合、このメソッドは ECMA-402 仕様に従って実装されなければならない。ECMA-402 API を含まない場合は、以下の仕様が使用される：
このメソッドは文字列値を返す。文字列の内容は
このメソッドのオプションパラメータの意味は ECMA-402 仕様で定義される。ECMA-402 サポートがない実装は、そのパラメータ位置を他の用途に使ってはならない。
21.4.4.40 Date.prototype.toLocaleTimeString ( [ reserved1 [ , reserved2 ] ] )
ECMAScript 実装が ECMA-402 国際化 API を含む場合、このメソッドは ECMA-402 仕様に従って実装されなければならない。ECMA-402 API を含まない場合は、以下の仕様が使用される：
このメソッドは文字列値を返す。文字列の内容は
このメソッドのオプションパラメータの意味は ECMA-402 仕様で定義される。ECMA-402 サポートがない実装は、そのパラメータ位置を他の用途に使ってはならない。
21.4.4.41 Date.prototype.toString ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - tv を dateObject.[[DateValue]] とする。
ToDateString (tv) を返す。
ある Date d について d.[[DateValue]] が
1000 で割り切れる場合、Date.parse(d.toString()) = d.valueOf()
となる。
このメソッドはジェネリックではなく、
21.4.4.41.1 TimeString ( tv )
抽象操作 TimeString は引数 tv（Number型。ただし
- hour を
ToZeroPaddedDecimalString (ℝ (HourFromTime (tv)), 2) に設定する。 - minute を
ToZeroPaddedDecimalString (ℝ (MinFromTime (tv)), 2) に設定する。 - second を
ToZeroPaddedDecimalString (ℝ (SecFromTime (tv)), 2) に設定する。 - hour、
":" 、minute、":" 、second、コードユニット 0x0020 (SPACE)、"GMT" の文字列連結 を返す。
21.4.4.41.2 DateString ( tv )
抽象操作 DateString は引数 tv（Number型。ただし
- weekday を
表65 のWeekDay (tv) に対応する Name とする。 - month を
表66 のMonthFromTime (tv) に対応する Name とする。 - day を
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2) に設定する。 - yv を
YearFromTime (tv) に設定する。 - yv が
+0 𝔽 または yv >+0 𝔽 なら yearSign を空文字列に、そうでなければ yearSign を"-" に設定する。 - paddedYear を
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4) に設定する。 - weekday、コードユニット 0x0020 (SPACE)、month、コードユニット 0x0020
(SPACE)、day、コードユニット 0x0020
(SPACE)、yearSign、paddedYear の
文字列連結 を返す。
| Number | Name |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Number | Name |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.4.4.41.3 TimeZoneString ( tv )
抽象操作 TimeZoneString は引数 tv（
- systemTimeZoneIdentifier を
SystemTimeZoneIdentifier () に設定する。 IsTimeZoneOffsetString (systemTimeZoneIdentifier) がtrue なら- offsetNs を
ParseTimeZoneOffsetString (systemTimeZoneIdentifier) に設定する。
- offsetNs を
- それ以外の場合
- offsetNs を
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier,ℤ (ℝ (tv) × 106)) に設定する。
- offsetNs を
- offset を
𝔽 (truncate (offsetNs / 106)) に設定する。 - offset が
+0 𝔽 または offset >+0 𝔽 の場合- offsetSign を
"+" に設定する。 - absOffset を offset に設定する。
- offsetSign を
- それ以外の場合
- offsetSign を
"-" に設定する。 - absOffset を -offset に設定する。
- offsetSign を
- offsetMin を
ToZeroPaddedDecimalString (ℝ (MinFromTime (absOffset)), 2) に設定する。 - offsetHour を
ToZeroPaddedDecimalString (ℝ (HourFromTime (absOffset)), 2) に設定する。 - tzName を空文字列またはコードユニット 0x0020 (SPACE)、コードユニット 0x0028 (LEFT
PARENTHESIS)、
実装定義 のタイムゾーン名、コードユニット 0x0029 (RIGHT PARENTHESIS) を文字列連結 したものに設定する。 - offsetSign、offsetHour、offsetMin、tzName
の
文字列連結 を返す。
21.4.4.41.4 ToDateString ( tv )
抽象操作 ToDateString は引数 tv（
- tv が
NaN なら"Invalid Date" を返す。 - t を
LocalTime (tv) に設定する。 DateString (t)、コードユニット 0x0020 (SPACE)、TimeString (t)、TimeZoneString (tv) の文字列連結 を返す。
21.4.4.42 Date.prototype.toTimeString ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - tv を dateObject.[[DateValue]] とする。
- tv が
NaN なら"Invalid Date" を返す。 - t を
LocalTime (tv) に設定する。 文字列連結 でTimeString (t) とTimeZoneString (tv) を連結して返す。
21.4.4.43 Date.prototype.toUTCString ( )
このメソッドは、
呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - tv を dateObject.[[DateValue]] とする。
- tv が
NaN なら"Invalid Date" を返す。 - weekday を
表65 のWeekDay (tv) に対応する Name とする。 - month を
表66 のMonthFromTime (tv) に対応する Name とする。 - day を
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2) に設定する。 - yv を
YearFromTime (tv) に設定する。 - yv が
+0 𝔽 または yv >+0 𝔽 なら yearSign を空文字列に、そうでなければ yearSign を"-" に設定する。 - paddedYear を
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4) に設定する。 - weekday、
"," 、コードユニット 0x0020 (SPACE)、day、コードユニット 0x0020 (SPACE)、month、コードユニット 0x0020 (SPACE)、yearSign、paddedYear、コードユニット 0x0020 (SPACE)、TimeString (tv) の文字列連結 を返す。
21.4.4.44 Date.prototype.valueOf ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- dateObject を
this の値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - dateObject.[[DateValue]] を返す。
21.4.4.45 Date.prototype [ %Symbol.toPrimitive% ] ( hint )
このメソッドは ECMAScript の言語演算子によって Date をプリミティブ値に変換するために呼び出される。hint の許容値は
呼び出されたとき、以下の手順を実行する：
- O を
this の値とする。 - O が
オブジェクトでない 場合、TypeError 例外をスローする。 - hint が
"string" または"default" なら- tryFirst を
string に設定する。
- tryFirst を
- それ以外で hint が
"number" なら- tryFirst を
number に設定する。
- tryFirst を
- その他の場合
TypeError 例外をスローする。
- ?
OrdinaryToPrimitive (O, tryFirst) を返す。
このプロパティの属性は { [[Writable]]:
このメソッドの
21.4.5 Date インスタンスのプロパティ
Date インスタンスは
22 テキスト処理
22.1 String オブジェクト
22.1.1 String コンストラクター
String
- %String% である。
グローバルオブジェクト の"String" プロパティの初期値である。コンストラクター として呼び出されたとき、新しい String オブジェクトを作成し初期化する。コンストラクター としてではなく関数として呼び出されたとき、型変換を行う。- クラス定義の
extends節の値として使用できる。指定された String の動作を継承するサブクラスコンストラクター は、superで Stringコンストラクター を呼び出し、サブクラスインスタンスの [[StringData]] 内部スロットを作成・初期化しなければならない。
22.1.1.1 String ( value )
この関数は呼び出されたとき、以下の手順を実行する：
- value が存在しない場合、
- s を空文字列とする。
- それ以外の場合、
- NewTarget が
undefined で、かつ value がSymbol の場合、SymbolDescriptiveString (value) を返す。 - s を ?
ToString (value) に設定する。
- NewTarget が
- NewTarget が
undefined なら、s を返す。 StringCreate (s, ?GetPrototypeFromConstructor (NewTarget,"%String.prototype%" )) を返す。
22.1.2 String コンストラクターのプロパティ
String
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
22.1.2.1 String.fromCharCode ( ...codeUnits )
この関数は任意個の引数で呼び出すことができ、引数は rest パラメータ codeUnits となる。
呼び出されたとき、以下の手順を実行する：
この関数の
22.1.2.2 String.fromCodePoint ( ...codePoints )
この関数は任意個の引数で呼び出すことができ、引数は rest パラメータ codePoints となる。
呼び出されたとき、以下の手順を実行する：
- result を空文字列とする。
- codePoints の各要素 next について、
- nextCP を ?
ToNumber (next) に設定する。 - nextCP が
整数値 Number でなければ、RangeError 例外をスローする。 ℝ (nextCP) < 0 またはℝ (nextCP) > 0x10FFFF なら、RangeError 例外をスローする。- result を
文字列連結 で result とUTF16EncodeCodePoint (ℝ (nextCP)) を連結したものに設定する。
- nextCP を ?
アサート : codePoints が空なら result は空文字列である。- result を返す。
この関数の
22.1.2.3 String.prototype
String.prototype の初期値は
このプロパティの属性は { [[Writable]]:
22.1.2.4 String.raw ( template, ...substitutions )
この関数は可変長の引数で呼び出すことができる。最初の引数が template であり、残りの引数は
呼び出されたとき、以下の手順を実行する：
- substitutionCount を substitutions の要素数とする。
- cooked を ?
ToObject (template) に設定する。 - literals を ?
ToObject (?Get (cooked,"raw" )) に設定する。 - literalCount を ?
LengthOfArrayLike (literals) に設定する。 - literalCount ≤ 0 なら空文字列を返す。
- R を空文字列とする。
- nextIndex を 0 とする。
- 次を繰り返す：
この関数は Tagged Template (
22.1.3 String プロトタイプオブジェクトのプロパティ
String プロトタイプオブジェクト：
- %String.prototype% である。
String エキゾチックオブジェクト であり、そのようなオブジェクトに指定された内部メソッドを持つ。- [[StringData]] 内部スロットを持ち、その値は空文字列である。
"length" プロパティを持ち、その初期値は+0 𝔽 であり、属性は { [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false } である。- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% である。
特に明示されない限り、以下で定義される String プロトタイプオブジェクトのメソッドはジェネリックではなく、渡される
22.1.3.1 String.prototype.at ( index )
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - len を S の長さとする。
- relativeIndex を ?
ToIntegerOrInfinity (index) に設定する。 - relativeIndex ≥ 0 なら
- k を relativeIndex に設定する。
- それ以外の場合
- k を len + relativeIndex に設定する。
- k < 0 または k ≥ len なら
undefined を返す。 - S の k から k+1 までの
substring を返す。
22.1.3.2 String.prototype.charAt ( pos )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - position を ?
ToIntegerOrInfinity (pos) に設定する。 - size を S の長さとする。
- position < 0 または position ≥ size なら空文字列を返す。
- S の position から position+1 までの
substring を返す。
このメソッドは意図的にジェネリックであり、
22.1.3.3 String.prototype.charCodeAt ( pos )
このメソッドは、このオブジェクトを String に変換した値の pos インデックスにあるコードユニットの数値（0以上
216 未満の
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - position を ?
ToIntegerOrInfinity (pos) に設定する。 - size を S の長さとする。
- position < 0 または position ≥ size なら
NaN を返す。 - S の position インデックスにあるコードユニットの数値の
Number値 を返す。
このメソッドは意図的にジェネリックであり、
22.1.3.4 String.prototype.codePointAt ( pos )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - position を ?
ToIntegerOrInfinity (pos) に設定する。 - size を S の長さとする。
- position < 0 または position ≥ size なら
undefined を返す。 - cp を
CodePointAt (S, position) に設定する。 𝔽 (cp.[[CodePoint]]) を返す。
このメソッドは意図的にジェネリックであり、
22.1.3.5 String.prototype.concat ( ...args )
このメソッドが呼び出されると、
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - R を S に設定する。
- args の各要素 next について、
- R を返す。
このメソッドの
このメソッドは意図的にジェネリックであり、
22.1.3.6 String.prototype.constructor
String.prototype.constructor の初期値は
22.1.3.7 String.prototype.endsWith ( searchString [ , endPosition ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - isRegExp を ?
IsRegExp (searchString) に設定する。 - isRegExp が
true ならTypeError 例外をスローする。 - searchStr を ?
ToString (searchString) に設定する。 - len を S の長さとする。
- endPosition が
undefined なら pos を len に、それ以外は pos を ?ToIntegerOrInfinity (endPosition) に設定する。 - end を
clamping で pos を 0 から len の範囲に調整した値とする。 - searchLength を searchStr の長さとする。
- searchLength = 0 なら
true を返す。 - start を end - searchLength に設定する。
- start < 0 なら
false を返す。 - substring を S の start から end
までの
substring とする。 - substring が searchStr なら
true を返す。 false を返す。
このメソッドは、searchString を String に変換したコードユニットの並びが、このオブジェクト（String 変換済）の
endPosition - length(this) から始まるコードユニットの並びと一致する場合
第1引数が RegExp の場合に例外を投げる仕様は、将来版でそのような引数値を許可する拡張を定義できるようにするためである。
このメソッドは意図的にジェネリックであり、
22.1.3.8 String.prototype.includes ( searchString [ , position ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - isRegExp を ?
IsRegExp (searchString) に設定する。 - isRegExp が
true ならTypeError 例外をスローする。 - searchStr を ?
ToString (searchString) に設定する。 - pos を ?
ToIntegerOrInfinity (position) に設定する。 アサート : position がundefined なら pos は 0 である。- len を S の長さとする。
- start を
clamping で pos を 0 から len の範囲に調整した値とする。 - index を
StringIndexOf (S, searchStr, start) に設定する。 - index が
not-found ならfalse を返す。 true を返す。
searchString が、このオブジェクトを String に変換した結果の position
以上のインデックスで
第1引数が RegExp の場合に例外を投げる仕様は、将来版でそのような引数値を許可する拡張を定義できるようにするためである。
このメソッドは意図的にジェネリックであり、
22.1.3.9 String.prototype.indexOf ( searchString [ , position ] )
searchString が、このオブジェクトを String に変換した結果の position
以上のインデックスで
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - searchStr を ?
ToString (searchString) に設定する。 - pos を ?
ToIntegerOrInfinity (position) に設定する。 アサート : position がundefined なら pos は 0 である。- len を S の長さとする。
- start を
clamping で pos を 0 から len の範囲に調整した値とする。 - result を
StringIndexOf (S, searchStr, start) に設定する。 - result が
not-found なら-1 𝔽 を返す。 𝔽 (result) を返す。
このメソッドは意図的にジェネリックであり、
22.1.3.10 String.prototype.isWellFormed ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 IsStringWellFormedUnicode (S) を返す。
22.1.3.11 String.prototype.lastIndexOf ( searchString [ , position ] )
searchString が、このオブジェクトを String に変換した結果の position
以下のインデックスで
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - searchStr を ?
ToString (searchString) に設定する。 - numPos を ?
ToNumber (position) に設定する。 アサート : position がundefined なら numPos はNaN である。- numPos が
NaN なら pos を +∞ に、そうでなければ pos を !ToIntegerOrInfinity (numPos) に設定する。 - len を S の長さとする。
- searchLen を searchStr の長さとする。
- start を
clamping で pos を 0 から len - searchLen の範囲に調整した値とする。 - result を
StringLastIndexOf (S, searchStr, start) に設定する。 - result が
not-found なら-1 𝔽 を返す。 𝔽 (result) を返す。
このメソッドは意図的にジェネリックであり、
22.1.3.12 String.prototype.localeCompare ( that [ , reserved1 [ , reserved2 ] ] )
ECMAScript 実装が ECMA-402 国際化 API を含む場合、このメソッドは ECMA-402 仕様に従って実装されなければならない。ECMA-402 API を含まない場合は、以下の仕様が使用される：
このメソッドは
比較の前に、このメソッドは以下の準備を行う：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - thatValue を ?
ToString (that) に設定する。
このメソッドの第2・第3引数の意味は ECMA-402 仕様で定義される。ECMA-402 サポートがない実装は、その位置に他の意味を割り当ててはならない。
実際の返り値は
このメソッド自体は Array.prototype.sort の引数には直接適さない。sort は2引数関数を必要とするため。
このメソッドは ECMAScript 環境の
// Å ANGSTROM SIGN vs.
// Å LATIN CAPITAL LETTER A + COMBINING RING ABOVE
"\u212B".localeCompare("A\u030A")
// Ω OHM SIGN vs.
// Ω GREEK CAPITAL LETTER OMEGA
"\u2126".localeCompare("\u03A9")
// ṩ LATIN SMALL LETTER S WITH DOT BELOW AND DOT ABOVE vs.
// ṩ LATIN SMALL LETTER S + COMBINING DOT ABOVE + COMBINING DOT BELOW
"\u1E69".localeCompare("s\u0307\u0323")
// ḍ̇ LATIN SMALL LETTER D WITH DOT ABOVE + COMBINING DOT BELOW vs.
// ḍ̇ LATIN SMALL LETTER D WITH DOT BELOW + COMBINING DOT ABOVE
"\u1E0B\u0323".localeCompare("\u1E0D\u0307")
// 가 HANGUL CHOSEONG KIYEOK + HANGUL JUNGSEONG A vs.
// 가 HANGUL SYLLABLE GA
"\u1100\u1161".localeCompare("\uAC00")正規等価性の定義や議論は Unicode Standard の第2章、第3章、および Unicode Standard Annex #15, Unicode Normalization Forms、Unicode Technical Note #5, Canonical Equivalence in Applications、Unicode Technical Standard #10, Unicode Collation Algorithm も参照されたい。
Unicode Standard 第3章 3.7節で定義される互換等価性や互換分解は尊重しないことが推奨される。
このメソッドは意図的にジェネリックであり、
22.1.3.13 String.prototype.match ( regexp )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - regexp が
undefined でもnull でもない場合、- matcher を ?
GetMethod (regexp,%Symbol.match% ) に設定する。 - matcher が
undefined でなければ、- ?
Call (matcher, regexp, « O ») を返す。
- ?
- matcher を ?
- S を ?
ToString (O) に設定する。 - rx を ?
RegExpCreate (regexp,undefined ) に設定する。 - ?
Invoke (rx,%Symbol.match% , « S ») を返す。
このメソッドは意図的にジェネリックであり、
22.1.3.14 String.prototype.matchAll ( regexp )
このメソッドは、
呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - regexp が
undefined でもnull でもない場合、- isRegExp を ?
IsRegExp (regexp) に設定する。 - isRegExp が
true なら、- flags を ?
Get (regexp,"flags" ) に設定する。 - ?
RequireObjectCoercible (flags) を実行する。 - ?
ToString (flags) に"g" が含まれなければTypeError 例外をスローする。
- flags を ?
- matcher を ?
GetMethod (regexp,%Symbol.matchAll% ) に設定する。 - matcher が
undefined でなければ、- ?
Call (matcher, regexp, « O ») を返す。
- ?
- isRegExp を ?
- S を ?
ToString (O) に設定する。 - rx を ?
RegExpCreate (regexp,"g" ) に設定する。 - ?
Invoke (rx,%Symbol.matchAll% , « S ») を返す。
String.prototype.split
同様、String.prototype.matchAll は通常入力を変更せずに動作するよう設計されている。
22.1.3.15 String.prototype.normalize ( [ form ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - form が
undefined なら f を"NFC" に設定する。 - それ以外の場合は f を ?
ToString (form) に設定する。 - f が
"NFC" 、"NFD" 、"NFKC" 、"NFKD" のいずれでもなければRangeError 例外をスローする。 - ns を 最新のUnicode Standard, Normalization Forms で指定された通り S を f という名前の正規化形式に正規化した結果の String 値とする。
- ns を返す。
このメソッドは意図的にジェネリックであり、
22.1.3.16 String.prototype.padEnd ( maxLength [ , fillString ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - ?
StringPaddingBuiltinsImpl (O, maxLength, fillString,end ) を返す。
22.1.3.17 String.prototype.padStart ( maxLength [ , fillString ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - ?
StringPaddingBuiltinsImpl (O, maxLength, fillString,start ) を返す。
22.1.3.17.1 StringPaddingBuiltinsImpl ( O, maxLength, fillString, placement )
抽象操作 StringPaddingBuiltinsImpl は引数 O（
- S を ?
ToString (O) に設定する。 - intMaxLength を
ℝ (?ToLength (maxLength)) に設定する。 - stringLength を S の長さとする。
- intMaxLength ≤ stringLength なら S を返す。
- fillString が
undefined なら、fillString をコードユニット 0x0020 (SPACE) のみからなる文字列に設定する。 - それ以外の場合、fillString を ?
ToString (fillString) に設定する。 StringPad (S, intMaxLength, fillString, placement) を返す。
22.1.3.17.2 StringPad ( S, maxLength, fillString, placement )
抽象操作 StringPad は引数 S（String）、maxLength（非負
- stringLength を S の長さとする。
- maxLength ≤ stringLength なら S を返す。
- fillString が空文字列なら S を返す。
- fillLen を maxLength - stringLength に設定する。
- truncatedStringFiller を fillString を繰り返し連結し、長さ fillLen に切り詰めた文字列とする。
- placement が
start なら、文字列連結 で truncatedStringFiller と S を連結したものを返す。 - それ以外の場合、
文字列連結 で S と truncatedStringFiller を連結したものを返す。
maxLength 引数は S の長さ未満にならないよう調整される。
fillString 引数はデフォルトで
22.1.3.17.3 ToZeroPaddedDecimalString ( n, minLength )
抽象操作 ToZeroPaddedDecimalString は引数 n（非負
- S を n の10進数表現の文字列とする。
StringPad (S, minLength,"0" ,start ) を返す。
22.1.3.18 String.prototype.repeat ( count )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - n を ?
ToIntegerOrInfinity (count) に設定する。 - n < 0 または n = +∞ なら
RangeError 例外をスローする。 - n = 0 なら空文字列を返す。
- S を n 回連結した文字列値を返す。
このメソッドは
このメソッドは意図的にジェネリックであり、
22.1.3.19 String.prototype.replace ( searchValue, replaceValue )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - searchValue が
undefined でもnull でもない場合、- replacer を ?
GetMethod (searchValue,%Symbol.replace% ) に設定する。 - replacer が
undefined でなければ、- ?
Call (replacer, searchValue, « O, replaceValue ») を返す。
- ?
- replacer を ?
- string を ?
ToString (O) に設定する。 - searchString を ?
ToString (searchValue) に設定する。 - functionalReplace を
IsCallable (replaceValue) に設定する。 - functionalReplace が
false なら、- replaceValue を ?
ToString (replaceValue) に設定する。
- replaceValue を ?
- searchLength を searchString の長さとする。
- position を
StringIndexOf (string, searchString, 0) に設定する。 - position が
not-found なら string を返す。 - preceding を string の 0 から position までの
substring とする。 - following を string の position +
searchLength からの
substring とする。 - functionalReplace が
true なら、 - それ以外の場合、
Assert : replaceValue はString である。- captures を新しい空の
List とする。 - replacement を !
GetSubstitution (searchString, string, position, captures,undefined , replaceValue) に設定する。
文字列連結 で preceding、replacement、following を連結したものを返す。
このメソッドは意図的にジェネリックであり、
22.1.3.19.1 GetSubstitution ( matched, str, position, captures, namedCaptures, replacementTemplate )
抽象操作 GetSubstitution は引数
matched（String）、str（String）、position（非負
- stringLength を str の長さとする。
Assert : position ≤ stringLength。- result を空文字列とする。
- templateRemainder を replacementTemplate に設定する。
- templateRemainder が空文字列でない間、繰り返す：
- 注：以下の手順で ref（templateRemainder の接頭辞）を抽出し、refReplacement（その置換文字列）を決定し、resultに追加する。
- templateRemainder が
"$$" で始まるなら、- ref を
"$$" に設定する。 - refReplacement を
"$" に設定する。
- ref を
- それ以外で templateRemainder が
"$`" で始まるなら、- ref を
"$`" に設定する。 - refReplacement を str の 0 から
position までの
substring とする。
- ref を
- それ以外で templateRemainder が
"$&" で始まるなら、- ref を
"$&" に設定する。 - refReplacement を matched に設定する。
- ref を
- それ以外で templateRemainder が
"$'" （0x0024 (DOLLAR SIGN) + 0x0027 (APOSTROPHE)）で始まるなら、- ref を
"$'" に設定する。 - matchLength を matched の長さとする。
- tailPos を position + matchLength に設定する。
- refReplacement を str の
min (tailPos, stringLength) からのsubstring とする。 - 注：tailPos が stringLength を超えるのは、この抽象操作が
intrinsic
%Symbol.replace% メソッドによって%RegExp.prototype% の"exec" プロパティが intrinsic %RegExp.prototype.exec% でないオブジェクトで呼び出された場合のみ。
- ref を
- それ以外で templateRemainder が
"$" + 1つ以上の decimal digit で始まるなら、- templateRemainder が
"$" + 2つ以上のdecimal digitで始まるなら digitCount を2に、それ以外は1に設定する。 - digits を templateRemainder の 1 から 1 +
digitCount までの
substring とする。 - index を
ℝ (StringToNumber (digits)) に設定する。 Assert : 0 ≤ index ≤ 99。- captureLen を captures の要素数とする。
- index > captureLen かつ
digitCount = 2 なら、
- 注：2桁パターンでグループ数を超える場合は1桁パターン＋リテラルdigit扱い。
- digitCount を1に設定する。
- digits を digits の0から1までの
substring とする。 - index を
ℝ (StringToNumber (digits)) に設定する。
- ref を templateRemainder の 0 から 1 +
digitCount までの
substring とする。 - 1 ≤ index ≤ captureLen なら、
- capture を captures[index-1] に設定する。
- capture が
undefined なら、- refReplacement を空文字列に設定する。
- それ以外は、
- refReplacement を capture に設定する。
- それ以外は、
- refReplacement を ref に設定する。
- templateRemainder が
- それ以外で templateRemainder が
"$<" で始まるなら、- gtPos を
StringIndexOf (templateRemainder,">" , 0) に設定する。 - gtPos が
not-found または namedCaptures がundefined なら- ref を
"$<" に設定する。 - refReplacement を ref に設定する。
- ref を
- それ以外は、
- ref を templateRemainder の 0 から
gtPos+1 までの
substring とする。 - groupName を templateRemainder の 2
から gtPos までの
substring とする。 Assert : namedCaptures はObject である。- capture を ?
Get (namedCaptures, groupName) に設定する。 - capture が
undefined なら、- refReplacement を空文字列に設定する。
- それ以外は、
- refReplacement を ?
ToString (capture) に設定する。
- refReplacement を ?
- ref を templateRemainder の 0 から
gtPos+1 までの
- gtPos を
- それ以外は、
- ref を templateRemainder の 0 から 1
までの
substring とする。 - refReplacement を ref に設定する。
- ref を templateRemainder の 0 から 1
までの
- refLength を ref の長さとする。
- templateRemainder を templateRemainder の
refLength からの
substring とする。 - result を
文字列連結 で result と refReplacement を連結したものに設定する。
- result を返す。
22.1.3.20 String.prototype.replaceAll ( searchValue, replaceValue )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - searchValue が
undefined でもnull でもない場合、- isRegExp を ?
IsRegExp (searchValue) に設定する。 - isRegExp が
true なら、- flags を ?
Get (searchValue,"flags" ) に設定する。 - ?
RequireObjectCoercible (flags) を実行する。 - ?
ToString (flags) に"g" が含まれていなければTypeError 例外をスローする。
- flags を ?
- replacer を ?
GetMethod (searchValue,%Symbol.replace% ) に設定する。 - replacer が
undefined でなければ、- ?
Call (replacer, searchValue, « O, replaceValue ») を返す。
- ?
- isRegExp を ?
- string を ?
ToString (O) に設定する。 - searchString を ?
ToString (searchValue) に設定する。 - functionalReplace を
IsCallable (replaceValue) に設定する。 - functionalReplace が
false なら、- replaceValue を ?
ToString (replaceValue) に設定する。
- replaceValue を ?
- searchLength を searchString の長さとする。
- advanceBy を
max (1, searchLength) に設定する。 - matchPositions を新しい空の
List とする。 - position を
StringIndexOf (string, searchString, 0) に設定する。 - position が
not-found でない間、繰り返す：- position を matchPositions に追加する。
- position を
StringIndexOf (string, searchString, position + advanceBy) に設定する。
- endOfLastMatch を 0 に設定する。
- result を空文字列に設定する。
- matchPositions の各要素 p について、
- preserved を string の endOfLastMatch から
p までの
substring とする。 - functionalReplace が
true なら、 - それ以外の場合、
Assert : replaceValue はString である。- captures を新しい空の
List とする。 - replacement を !
GetSubstitution (searchString, string, p, captures,undefined , replaceValue) に設定する。
- result を
文字列連結 で result、preserved、replacement を連結したものに設定する。 - endOfLastMatch を p + searchLength に設定する。
- preserved を string の endOfLastMatch から
p までの
- endOfLastMatch が string の長さ未満なら、
- result を返す。
22.1.3.21 String.prototype.search ( regexp )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - regexp が
undefined でもnull でもない場合、- searcher を ?
GetMethod (regexp,%Symbol.search% ) に設定する。 - searcher が
undefined でなければ、- ?
Call (searcher, regexp, « O ») を返す。
- ?
- searcher を ?
- string を ?
ToString (O) に設定する。 - rx を ?
RegExpCreate (regexp,undefined ) に設定する。 - ?
Invoke (rx,%Symbol.search% , « string ») を返す。
このメソッドは意図的にジェネリックであり、
22.1.3.22 String.prototype.slice ( start, end )
このメソッドは、このオブジェクトを String に変換した結果の start インデックスから end インデックス（または
end が
呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - len を S の長さとする。
- intStart を ?
ToIntegerOrInfinity (start) に設定する。 - intStart = -∞ なら from を 0 に設定する。
- それ以外で intStart < 0 なら from を
max (len + intStart, 0) に設定する。 - それ以外の場合 from を
min (intStart, len) に設定する。 - end が
undefined なら intEnd を len に、それ以外は intEnd を ?ToIntegerOrInfinity (end) に設定する。 - intEnd = -∞ なら to を 0 に設定する。
- それ以外で intEnd < 0 なら to を
max (len + intEnd, 0) に設定する。 - それ以外の場合 to を
min (intEnd, len) に設定する。 - from ≥ to なら空文字列を返す。
- S の from から to までの
substring を返す。
このメソッドは意図的にジェネリックであり、
22.1.3.23 String.prototype.split ( separator, limit )
このメソッドは、このオブジェクトを String に変換した結果の部分文字列を格納した Array を返す。部分文字列は separator
を左から右へ検索して決定される。これらは返される配列のいずれの String にも含まれず、区切りの役割のみを果たす。separator
の値は任意長の文字列でも、
呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - separator が
undefined でもnull でもない場合、- splitter を ?
GetMethod (separator,%Symbol.split% ) に設定する。 - splitter が
undefined でなければ、- ?
Call (splitter, separator, « O, limit ») を返す。
- ?
- splitter を ?
- S を ?
ToString (O) に設定する。 - limit が
undefined なら lim を 232 - 1 に、それ以外は lim をℝ (?ToUint32 (limit)) に設定する。 - R を ?
ToString (separator) に設定する。 - lim = 0 なら、
CreateArrayFromList (« ») を返す。
- separator が
undefined なら、CreateArrayFromList (« S ») を返す。
- separatorLength を R の長さとする。
- separatorLength = 0 なら、
- strLen を S の長さとする。
- outLen を
clamping lim を 0 から strLen の範囲に設定した値とする。 - head を S の 0 から outLen までの
substring とする。 - codeUnits を head のコードユニットを要素とする
List とする。 CreateArrayFromList (codeUnits) を返す。
- S が空文字列なら
CreateArrayFromList (« S ») を返す。 - substrings を新しい空の
List とする。 - i を 0 に設定する。
- j を
StringIndexOf (S, R, 0) に設定する。 - j が
not-found でない間、繰り返す：- T を S の i から j までの
substring とする。 - T を substrings に追加する。
- substrings の要素数が lim なら
CreateArrayFromList (substrings) を返す。 - i を j + separatorLength に設定する。
- j を
StringIndexOf (S, R, i) に設定する。
- T を S の i から j までの
- T を S の i からの
substring とする。 - T を substrings に追加する。
CreateArrayFromList (substrings) を返す。
separator の値は空文字列でもよい。この場合、separator は入力文字列の先頭や末尾、または前の
separator マッチ末尾の空
separator が
このメソッドは意図的にジェネリックであり、
22.1.3.24 String.prototype.startsWith ( searchString [ , position ] )
このメソッドは呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - isRegExp を ?
IsRegExp (searchString) に設定する。 - isRegExp が
true ならTypeError 例外をスローする。 - searchStr を ?
ToString (searchString) に設定する。 - len を S の長さとする。
- position が
undefined なら pos を 0 に、それ以外は pos を ?ToIntegerOrInfinity (position) に設定する。 - start を
clamping で pos を 0 から len の範囲に調整した値とする。 - searchLength を searchStr の長さとする。
- searchLength = 0 なら
true を返す。 - end を start + searchLength に設定する。
- end > len なら
false を返す。 - substring を S の start から end
までの
substring とする。 - substring が searchStr なら
true を返す。 false を返す。
このメソッドは、searchString を String に変換したコードユニットの並びが、このオブジェクト（String 変換済）の
position インデックスから始まるコードユニットの並びと一致する場合
第1引数が RegExp の場合に例外を投げる仕様は、将来版でそのような引数値を許可する拡張を定義できるようにするためである。
このメソッドは意図的にジェネリックであり、
22.1.3.25 String.prototype.substring ( start, end )
このメソッドは、このオブジェクトを String に変換した結果の start インデックスから end インデックス（または
end が
いずれかの引数が
start が end より大きい場合は、値を入れ替える。
呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - len を S の長さとする。
- intStart を ?
ToIntegerOrInfinity (start) に設定する。 - end が
undefined なら intEnd を len に、それ以外は intEnd を ?ToIntegerOrInfinity (end) に設定する。 - finalStart を
clamping で intStart を 0 から len の範囲に調整した値とする。 - finalEnd を
clamping で intEnd を 0 から len の範囲に調整した値とする。 - from を
min (finalStart, finalEnd) に設定する。 - to を
max (finalStart, finalEnd) に設定する。 - S の from から to までの
substring を返す。
このメソッドは意図的にジェネリックであり、
22.1.3.26 String.prototype.toLocaleLowerCase ( [ reserved1 [ , reserved2 ] ] )
ECMAScript 実装が ECMA-402 国際化 API を含む場合、このメソッドは ECMA-402 仕様に従って実装されなければならない。ECMA-402 API を含まない場合は、以下の仕様が使用される：
このメソッドは
toLowerCase と全く同じように動作するが、
このメソッドのオプションパラメータの意味は ECMA-402 仕様で定義される。ECMA-402 サポートがない実装は、その位置に他の意味を割り当ててはならない。
このメソッドは意図的にジェネリックであり、
22.1.3.27 String.prototype.toLocaleUpperCase ( [ reserved1 [ , reserved2 ] ] )
ECMAScript 実装が ECMA-402 国際化 API を含む場合、このメソッドは ECMA-402 仕様に従って実装されなければならない。ECMA-402 API を含まない場合は、以下の仕様が使用される：
このメソッドは
toUpperCase と全く同じように動作するが、
このメソッドのオプションパラメータの意味は ECMA-402 仕様で定義される。ECMA-402 サポートがない実装は、その位置に他の意味を割り当ててはならない。
このメソッドは意図的にジェネリックであり、
22.1.3.28 String.prototype.toLowerCase ( )
このメソッドは
呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - sText を
StringToCodePoints (S) に設定する。 - lowerText を Unicode Default Case Conversion algorithm に従い toLowercase(sText) に設定する。
- L を
CodePointsToString (lowerText) に設定する。 - L を返す。
結果は Unicode Character Database のロケール非依存のケースマッピングに従って導出されなければならない（UnicodeData.txt
および付随する SpecialCasing.txt
のロケール非依存マッピングを含む）。
一部のコードポイントのケースマッピングは複数コードポイントになる場合がある。この場合、結果の文字列の長さは元の文字列と同じにならないことがある。また
toUpperCase と toLowerCase は文脈依存なので、両者は対称的ではない。つまり
s.toUpperCase().toLowerCase() は必ずしも s.toLowerCase()
と等しくならない。
このメソッドは意図的にジェネリックであり、
22.1.3.29 String.prototype.toString ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- ?
ThisStringValue (this の値) を返す。
String オブジェクトの場合、このメソッドは valueOf メソッドと同じものを返すことになる。
22.1.3.30 String.prototype.toUpperCase ( )
このメソッドは
String.prototype.toLowerCase と全く同じように動作するが、文字列は Unicode Default Case Conversion
の toUppercase アルゴリズムでマッピングされる。
このメソッドは意図的にジェネリックであり、
22.1.3.31 String.prototype.toWellFormed ( )
このメソッドは、このオブジェクトの文字列表現を返す。ただし、
呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - S を ?
ToString (O) に設定する。 - strLen を S の長さとする。
- k を 0 に設定する。
- result を空文字列に設定する。
- k < strLen の間、繰り返す：
- cp を
CodePointAt (S, k) に設定する。 - cp.[[IsUnpairedSurrogate]] が
true なら、- result を
文字列連結 で result と 0xFFFD（置換文字）を連結したものに設定する。
- result を
- それ以外の場合、
- result を
文字列連結 で result とUTF16EncodeCodePoint (cp.[[CodePoint]]) を連結したものに設定する。
- result を
- k を k + cp.[[CodeUnitCount]] に設定する。
- cp を
- result を返す。
22.1.3.32 String.prototype.trim ( )
このメソッドは
呼び出されたとき、以下の手順を実行する：
- S を
this の値とする。 - ?
TrimString (S,start+end ) を返す。
このメソッドはジェネリックで設計されており、
22.1.3.32.1 TrimString ( string, where )
抽象操作 TrimString は引数 string（
- str を ?
RequireObjectCoercible (string) に設定する。 - S を ?
ToString (str) に設定する。 - where が
start なら、- T を S の先頭の空白文字を除去したコピーの文字列値とする。
- それ以外で where が
end なら、- T を S の末尾の空白文字を除去したコピーの文字列値とする。
- それ以外の場合、
Assert : where はstart+end である。- T を S の先頭と末尾両方の空白文字を除去したコピーの文字列値とする。
- T を返す。
空白文字の定義は
22.1.3.33 String.prototype.trimEnd ( )
このメソッドは
呼び出されたとき、以下の手順を実行する：
- S を
this の値とする。 - ?
TrimString (S,end ) を返す。
このメソッドはジェネリックで設計されており、
22.1.3.34 String.prototype.trimStart ( )
このメソッドは
呼び出されたとき、以下の手順を実行する：
- S を
this の値とする。 - ?
TrimString (S,start ) を返す。
このメソッドはジェネリックで設計されており、
22.1.3.35 String.prototype.valueOf ( )
このメソッドは呼び出されたとき、以下の手順を実行する：
- ?
ThisStringValue (this の値) を返す。
22.1.3.35.1 ThisStringValue ( value )
抽象操作 ThisStringValue は引数 value（
22.1.3.36 String.prototype [ %Symbol.iterator% ] ( )
このメソッドは、文字列値のコードポイントを順にイテレートし、それぞれのコードポイントを文字列値として返す
呼び出されたとき、以下の手順を実行する：
- O を ?
RequireObjectCoercible (this の値) に設定する。 - s を ?
ToString (O) に設定する。 - closure を s をキャプチャし、呼び出されたとき次のステップを実行するパラメータなしの新しい
抽象クロージャ とする：- len を s の長さとする。
- position を 0 に設定する。
- position < len の間、繰り返す：
- cp を
CodePointAt (s, position) に設定する。 - nextIndex を position + cp.[[CodeUnitCount]] に設定する。
- resultString を s の position から
nextIndex までの
substring とする。 - position を nextIndex に設定する。
- ?
GeneratorYield (CreateIteratorResultObject (resultString,false )) を実行する。
- cp を
NormalCompletion (unused ) を返す。
CreateIteratorFromClosure (closure,"%StringIteratorPrototype%" ,%StringIteratorPrototype% ) を返す。
このメソッドの
22.1.4 String インスタンスのプロパティ
String インスタンスは
String インスタンスは
22.1.4.1 length
この String オブジェクトが表す String 値の要素数。
String オブジェクトが初期化された後、このプロパティは変化しない。属性は { [[Writable]]:
22.1.5 String イテレータオブジェクト
String イテレータは、特定の String インスタンスオブジェクト上の特定のイテレーションを表すオブジェクトである。String
イテレータオブジェクトに対する名前付き
22.1.5.1 %StringIteratorPrototype% オブジェクト
%StringIteratorPrototype% オブジェクト：
- すべての
String イテレータオブジェクト が継承するプロパティを持つ。 通常のオブジェクト である。- [[Prototype]] 内部スロットを持ち、その値は
%Iterator.prototype% である。 - 以下のプロパティを持つ：
22.1.5.1.1 %StringIteratorPrototype%.next ( )
- ?
GeneratorResume (this の値,empty ,"%StringIteratorPrototype%" ) を返す。
22.1.5.1.2 %StringIteratorPrototype% [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
22.2 RegExp（正規表現）オブジェクト
RegExp オブジェクトは正規表現と関連するフラグを含む。
正規表現の形式と機能は Perl 5 プログラミング言語の正規表現機能をモデルにしている。
22.2.1 パターン
RegExp
構文
選択が曖昧な各 \u \u
u
ここで最初の2行は CharacterClass と同等である。
この節のいくつかの生成式は、
22.2.1.1 静的セマンティクス: 早期エラー
この節は
-
CountLeftCapturingParensWithin (Pattern ) ≥ 232 - 1 の場合、構文エラーとなる。 -
Pattern が2つの異なるGroupSpecifier x と y を含み、CapturingGroupName が x と y で等しく、かつMightBothParticipate (x, y) がtrue の場合、構文エラーとなる。
-
最初の
DecimalDigits の MV が2番目のDecimalDigits の MV より大きい場合、構文エラーとなる。
-
source text matched by RegularExpressionModifiers に同じコードポイントが複数回含まれている場合、構文エラーとなる。
-
最初の
RegularExpressionModifiers と２番目のRegularExpressionModifiers の両方とも source text matched が空の場合、構文エラーとなる。 -
最初の
RegularExpressionModifiers の source text matched に同じコードポイントが複数回含まれている場合、構文エラーとなる。 -
２番目の
RegularExpressionModifiers の source text matched に同じコードポイントが複数回含まれている場合、構文エラーとなる。 -
最初の
RegularExpressionModifiers の source text matched の任意コードポイントが、２番目のRegularExpressionModifiers の source text matched にも含まれている場合、構文エラーとなる。
-
GroupSpecifiersThatMatch (GroupName ) が空の場合、構文エラーとなる。
-
CapturingGroupNumber が、CountLeftCapturingParensWithin (そのPattern の中にAtomEscape があるもの) より大きい場合、構文エラーとなる。
-
最初の
ClassAtom のIsCharacterClass がtrue または、２番目のClassAtom のIsCharacterClass がtrue の場合、構文エラーとなる。 -
最初の
ClassAtom のIsCharacterClass がfalse かつ、２番目のClassAtom のIsCharacterClass がfalse であり、最初のClassAtom のCharacterValue が２番目のClassAtom のCharacterValue より大きい場合、構文エラーとなる。
-
ClassAtomNoDash のIsCharacterClass がtrue または、ClassAtom のIsCharacterClass がtrue の場合、構文エラーとなる。 -
ClassAtomNoDash のIsCharacterClass がfalse かつ、ClassAtom のIsCharacterClass がfalse であり、ClassAtomNoDash のCharacterValue がClassAtom のCharacterValue より大きい場合、構文エラーとなる。
-
RegExpUnicodeEscapeSequence のCharacterValue が、IdentifierStartChar 生成式でマッチするコードポイントの数値でない場合、構文エラーとなる。
-
RegExpIdentifierStart のRegExpIdentifierCodePoint がUnicodeIDStart 生成式でマッチしない場合、構文エラーとなる。
-
RegExpUnicodeEscapeSequence のCharacterValue が、IdentifierPartChar 生成式でマッチするコードポイントの数値でない場合、構文エラーとなる。
-
RegExpIdentifierPart のRegExpIdentifierCodePoint がUnicodeIDContinue 生成式でマッチしない場合、構文エラーとなる。
-
UnicodePropertyName のsource text matched by が Unicodeプロパティ名 またはProperty name およびエイリアス列に記載されていない場合（表69 ）、構文エラーとなる。 -
UnicodePropertyValue のsource text matched by が、そのUnicodePropertyName が示すUnicodeプロパティまたはプロパティエイリアスのプロパティ値またはプロパティ値エイリアスでない場合（PropertyValueAliases.txtに記載）、構文エラーとなる。
-
LoneUnicodePropertyNameOrValue のsource text matched by が、General_Category (gc) プロパティの Unicode プロパティ値またはプロパティ値エイリアスとしてPropertyValueAliases.txtに記載されていない場合、または表70 の「Property name and aliases」列に記載されているバイナリプロパティまたはバイナリプロパティエイリアスでない場合、または表71 の「Property name」列に記載されている文字列のバイナリプロパティでない場合、構文エラーとなる。 -
囲まれている
Pattern が [UnicodeSetsMode] パラメータを持たず、かつLoneUnicodePropertyNameOrValue のsource text matched by が表71 の「Property name」列に記載されている文字列のバイナリプロパティである場合、構文エラーとなる。
-
UnicodePropertyValueExpression のMayContainStrings がtrue の場合、構文エラーとなる。
-
ClassContents のMayContainStrings がtrue の場合、構文エラーとなる。
-
ClassContents のMayContainStrings がtrue の場合、構文エラーとなる。
-
最初の
ClassSetCharacter のCharacterValue が２番目のClassSetCharacter のCharacterValue より大きい場合、構文エラーとなる。
22.2.1.2 静的セマンティクス: CountLeftCapturingParensWithin ( node )
抽象操作 CountLeftCapturingParensWithin は引数 node（( パターン文字である。
この節は
呼び出されたとき、以下の手順を実行する：
Assert : node はRegExp パターン文法 の生成式のインスタンスである。- node に含まれる、次の
Atom :: ( GroupSpecifier opt Disjunction ) 構文ノード の数を返す。
22.2.1.3 静的セマンティクス: CountLeftCapturingParensBefore ( node )
抽象操作 CountLeftCapturingParensBefore は引数 node（
この節は
呼び出されたとき、以下の手順を実行する：
Assert : node はRegExp パターン文法 の生成式のインスタンスである。- pattern を node を含む
Pattern とする。 - pattern に含まれ、node の前に現れるか、node を含む、次の
Atom :: ( GroupSpecifier opt Disjunction ) 構文ノード の数を返す。
22.2.1.4 静的セマンティクス: MightBothParticipate ( x, y )
抽象操作 MightBothParticipate は、引数 x（
Assert : x と y は同じ囲みPattern を持つ。- 囲み
Pattern が、次のDisjunction :: Alternative | Disjunction 構文ノード を含み、x がAlternative 内にあり y が派生したDisjunction 内にある、または x が派生したDisjunction 内にあり y がAlternative 内にある場合、false を返す。 true を返す。
22.2.1.5 静的セマンティクス: CapturingGroupNumber
この節は
次の生成式ごとに分割定義される：
NonZeroDigit の MV を返す。
- n を
DecimalDigits のコードポイント数とする。 - （
NonZeroDigit の MV × 10n）にDecimalDigits の MV を加えた値を返す。
「
22.2.1.6 静的セマンティクス: IsCharacterClass
この節は
次の生成式ごとに分割定義される：
false を返す。
true を返す。
22.2.1.7 静的セマンティクス: CharacterValue
この節は
次の生成式ごとに分割定義される：
- U+002D（ハイフンマイナス）の数値を返す。
- ch を
SourceCharacter でマッチしたコードポイントとする。 - ch の数値を返す。
- U+0008（バックスペース）の数値を返す。
- U+002D（ハイフンマイナス）の数値を返す。
表67 に従い数値を返す。
| ControlEscape | 数値 | コードポイント | Unicode 名 | 記号 |
|---|---|---|---|---|
t
|
9 |
U+0009
|
CHARACTER TABULATION | <HT> |
n
|
10 |
U+000A
|
LINE FEED (LF) | <LF> |
v
|
11 |
U+000B
|
LINE TABULATION | <VT> |
f
|
12 |
U+000C
|
FORM FEED (FF) | <FF> |
r
|
13 |
U+000D
|
CARRIAGE RETURN (CR) | <CR> |
- ch を
AsciiLetter でマッチしたコードポイントとする。 - i を ch の数値とする。
- i を32で割った余りを返す。
- U+0000（NULL）の数値を返す。
\0 は <NUL> 文字を表し、直後に10進数字が続いてはならない。
HexEscapeSequence の MV を返す。
- lead を
HexLeadSurrogate のCharacterValue とする。 - trail を
HexTrailSurrogate のCharacterValue とする。 - cp を
UTF16SurrogatePairToCodePoint (lead, trail) とする。 - cp の数値を返す。
Hex4Digits の MV を返す。
CodePoint の MV を返す。
Hex4Digits の MV を返す。
- ch を
IdentityEscape でマッチしたコードポイントとする。 - ch の数値を返す。
- ch を
SourceCharacter でマッチしたコードポイントとする。 - ch の数値を返す。
- ch を
ClassSetReservedPunctuator でマッチしたコードポイントとする。 - ch の数値を返す。
- U+0008（バックスペース）の数値を返す。
22.2.1.8 静的セマンティクス: MayContainStrings
false を返す。
LoneUnicodePropertyNameOrValue のsource text matched by がProperty name の列にある文字列のバイナリプロパティ（表71 ）の場合、true を返す。false を返す。
ClassUnion が存在する場合、ClassUnion のMayContainStrings を返す。false を返す。
ClassSetOperand のMayContainStrings がtrue の場合、true を返す。ClassUnion が存在する場合、ClassUnion のMayContainStrings を返す。false を返す。
- 最初の
ClassSetOperand のMayContainStrings がfalse の場合、false を返す。 - ２番目の
ClassSetOperand のMayContainStrings がfalse の場合、false を返す。 true を返す。
ClassIntersection のMayContainStrings がfalse の場合、false を返す。ClassSetOperand のMayContainStrings がfalse の場合、false を返す。true を返す。
- 最初の
ClassSetOperand のMayContainStrings を返す。
ClassString のMayContainStrings がtrue の場合、true を返す。ClassStringDisjunctionContents のMayContainStrings を返す。
true を返す。
NonEmptyClassString が存在する場合、true を返す。false を返す。
22.2.1.9 静的セマンティクス: GroupSpecifiersThatMatch ( thisGroupName )
抽象操作 GroupSpecifiersThatMatch は引数 thisGroupName（
- name を thisGroupName の
CapturingGroupName とする。 - pattern を thisGroupName を含む
Pattern とする。 - result を新しい空の
List とする。 - pattern に含まれる各
GroupSpecifier gs について、- gs の
CapturingGroupName が name なら、- gs を result に追加する。
- gs の
- result を返す。
22.2.1.10 静的セマンティクス: CapturingGroupName
- idTextUnescaped を
RegExpIdentifierName のRegExpIdentifierCodePoints とする。 CodePointsToString (idTextUnescaped) を返す。
22.2.1.11 静的セマンティクス: RegExpIdentifierCodePoints
- cp を
RegExpIdentifierStart のRegExpIdentifierCodePoint とする。 - « cp » を返す。
- cps を派生した
RegExpIdentifierName のRegExpIdentifierCodePoints とする。 - cp を
RegExpIdentifierPart のRegExpIdentifierCodePoint とする。 - cps と « cp » の
リスト連結 を返す。
22.2.1.12 静的セマンティクス: RegExpIdentifierCodePoint
IdentifierStartChar でマッチしたコードポイントを返す。
IdentifierPartChar でマッチしたコードポイントを返す。
RegExpUnicodeEscapeSequence のCharacterValue の数値を持つコードポイントを返す。
- lead を
UnicodeLeadSurrogate でマッチしたコードポイントの数値を持つコードユニットとする。 - trail を
UnicodeTrailSurrogate でマッチしたコードポイントの数値を持つコードユニットとする。 UTF16SurrogatePairToCodePoint (lead, trail) を返す。
22.2.2 パターンの意味論
正規表現パターンは、以下に記載されたプロセスを使用して
uまたはvのどちらも含まれていない場合、BMPパターンである。それ以外の場合はUnicodeパターンである。BMPパターンは、Basic
Multilingual Plane
の範囲内のUnicodeコードポイントで構成された16ビット値のシーケンスとして解釈されるStringに対してマッチする。Unicodeパターンは、UTF-16でエンコードされたUnicodeコードポイントのシーケンスとして解釈されるStringに対してマッチする。BMPパターンの挙動を説明する文脈では「文字」は単一の16ビットUnicode
BMPコードポイントを意味する。Unicodeパターンの挙動を説明する文脈では「文字」はUTF-16でエンコードされたコードポイント(
たとえば、ソーステキストで表された単一の非BMP文字U+1D11E（MUSICAL SYMBOL G
CLEF）のパターンを考える。Unicodeパターンとして解釈した場合、これは単一のコードポイントU+1D11Eからなる1要素（文字）の
パターンは、RegExp
実装は実際にUTF-16への変換や変換解除を行わない可能性があるが、この仕様の意味論は、パターンマッチングの結果がそのような変換が行われたかのようになることを要求する。
22.2.2.1 記法
以下の記述では、次の内部データ構造を使用する：
-
CharSetElement は次の2つのいずれか：
-
rer.[[UnicodeSets]] が
false の場合、CharSetElement は上記パターン意味論の意味での文字である。 -
rer.[[UnicodeSets]] が
true の場合、CharSetElement は、上記パターン意味論の意味での文字の要素からなるシーケンスである。これには空のシーケンス、1文字のシーケンス、複数文字のシーケンスが含まれる。利便性のため、この種の CharSetElement を扱う場合、個々の文字は1文字のシーケンスと同様に扱われる。
-
rer.[[UnicodeSets]] が
- CharSet は CharSetElement の数学的集合である。
-
CaptureRange
は、
Record { [[StartIndex]], [[EndIndex]] } であり、キャプチャに含まれる文字の範囲を表す。[[StartIndex]] は Input 内の範囲の開始インデックス（含む）を表す整数 であり、[[EndIndex]] は Input 内の範囲の終了インデックス（含まない）を表す整数 である。任意のCaptureRange について、これらのインデックスは [[StartIndex]] ≤ [[EndIndex]] という不変条件を満たす必要がある。 -
MatchState は、
Record { [[Input]], [[EndIndex]], [[Captures]] } であり、[[Input]] はマッチ対象の String を表す文字のList 、[[EndIndex]] は整数 、[[Captures]] は、パターンの各左捕捉括弧 に対応する値のList である。MatchStates は正規表現マッチングアルゴリズムで部分的なマッチ状態を表すために使用される。[[EndIndex]] は、パターンでこれまでにマッチした最後の入力文字のインデックスに1を加えた値であり、[[Captures]] は捕捉括弧の結果を保持する。n番目 の [[Captures]] 要素は、n番目 の捕捉括弧でキャプチャした文字範囲を表すCaptureRange または、まだ到達していない場合はundefined となる。バックトラックのため、マッチ処理中は多数のMatchStates が存在することがある。 -
MatcherContinuation は、1つの
MatchState を引数に取り、MatchState またはfailure を返す抽象クロージャ である。MatcherContinuation は、クロージャで捕捉した値によって指定されたパターンの残り部分を Input に対して、与えられた中間状態からマッチしようとする。マッチに成功した場合、到達した最終的なMatchState を返し、失敗した場合はfailure を返す。 -
Matcher
は、2つの引数（
MatchState とMatcherContinuation ）を取り、MatchState またはfailure を返す抽象クロージャ である。Matcher は、クロージャで捕捉した値によって指定されたパターンの中間部分を、MatchState の [[Input]] に対して、与えられた中間状態からマッチしようとする。MatcherContinuation 引数は、残りのパターンをマッチさせるクロージャであるべきである。パターンの部分パターンをマッチし新しいMatchState を得た後、Matcher はその新しいMatchState にMatcherContinuation を呼び出し、残りのパターンもマッチできるかテストする。可能ならMatcher はMatchState を返す。そうでなければ、Matcher は選択点で他の選択肢を試み、MatcherContinuation を繰り返し呼び出し、成功するか、全ての可能性が尽きるまで試す。
22.2.2.1.1 RegExp レコード
RegExp Record
は、コンパイル時や場合によってはマッチ処理時に必要な RegExp の情報を保存するための
次のフィールドを持つ：
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[IgnoreCase]] | Boolean | RegExp のフラグに |
| [[Multiline]] | Boolean | RegExp のフラグに |
| [[DotAll]] | Boolean | RegExp のフラグに |
| [[Unicode]] | Boolean | RegExp のフラグに |
| [[UnicodeSets]] | Boolean | RegExp のフラグに |
| [[CapturingGroupsCount]] | 非負の |
RegExp のパターンに含まれる |
22.2.2.2 実行時意味論: CompilePattern
- m を、
Disjunction に対するCompileSubpattern （引数 rer とforward ）の結果とする。 - 引数 (Input, index) を持ち、rer と m
を捕捉し、呼び出されたとき次を行う新しい
抽象クロージャ を返す：Assert : Input は文字のList である。Assert : 0 ≤ index ≤ Input の要素数。- c を、引数 (y) を持ち、何も捕捉せず、呼び出されたとき次を行う新しい
MatcherContinuation とする：Assert : y はMatchState である。- y を返す。
- cap を、rer.[[CapturingGroupsCount]] 個の
undefined 値からなるList （インデックスは 1 から rer.[[CapturingGroupsCount]]）とする。 - x を
MatchState { [[Input]]: Input, [[EndIndex]]: index, [[Captures]]: cap } とする。 - m(x, c) を返す。
22.2.2.3 実行時意味論: CompileSubpattern
この節は
次の生成式ごとに分割定義される：
- m1 を
Alternative に対するCompileSubpattern （引数 rer と direction）の結果とする。 - m2 を
Disjunction に対するCompileSubpattern （引数 rer と direction）の結果とする。 MatchTwoAlternatives (m1, m2) を返す。
正規表現演算子 | は2つの選択肢を分離する。パターンはまず左側の | でスキップされた部分のパターン内の捕捉括弧は、String ではなく
/a|ab/.exec("abc")は
/((a)|(ab))((c)|(bc))/.exec("abc")は次の配列を返す：
["abc", "a", "a", undefined, "bc", undefined, "bc"]であり、次のものではない：
["abc", "ab", undefined, "ab", "c", "c", undefined]2つの選択肢が試される順序は direction の値に依存しない。
EmptyMatcher () を返す。
- m1 を
Alternative に対するCompileSubpattern （引数 rer と direction）の結果とする。 - m2 を
Term に対するCompileSubpattern （引数 rer と direction）の結果とする。 MatchSequence (m1, m2, direction) を返す。
連続する
CompileAssertion （Assertion 、引数 rer）を返す。
生成される
CompileAtom （Atom 、引数 rer と direction）を返す。
- m を
CompileAtom （Atom 、引数 rer と direction）の結果とする。 - q を
CompileQuantifier （Quantifier ）の結果とする。 Assert : q.[[Min]] ≤ q.[[Max]]。- parenIndex を
CountLeftCapturingParensBefore (Term ) の結果とする。 - parenCount を
CountLeftCapturingParensWithin (Atom ) の結果とする。 - 引数 (x, c)
を持ち、m、q、parenIndex、parenCount
を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。RepeatMatcher (m, q.[[Min]], q.[[Max]], q.[[Greedy]], x, c, parenIndex, parenCount) を返す。
22.2.2.3.1 RepeatMatcher ( m, min, max, greedy, x, c, parenIndex, parenCount )
抽象操作 RepeatMatcher は、引数 m（
- もし max = 0 なら、c(x) を返す。
- d を、引数 (y)
を持ち、m、min、max、greedy、x、c、parenIndex、parenCount
を捕捉し、呼び出されたとき次を行う新しい
MatcherContinuation とする：Assert : y はMatchState である。- もし min = 0 かつ y.[[EndIndex]] = x.[[EndIndex]] なら、
failure を返す。 - もし min = 0 なら min2 を 0 とし、そうでなければ min2 を min - 1 とする。
- もし max = +∞ なら max2 を +∞ とし、そうでなければ max2 を max - 1 とする。
RepeatMatcher (m, min2, max2, greedy, y, c, parenIndex, parenCount) を返す。
- cap を x.[[Captures]] のコピーとする。
- parenIndex + 1 から
parenIndex + parenCount までの
整数 k それぞれについて、cap[k] をundefined にセットする。 - Input を x.[[Input]] とする。
- e を x.[[EndIndex]] とする。
- xr を
MatchState { [[Input]]: Input, [[EndIndex]]: e, [[Captures]]: cap } とする。 - もし min ≠ 0 なら m(xr, d) を返す。
- もし greedy が
false なら、- z を c(x) とする。
- z が
failure でなければ z を返す。 - m(xr, d) を返す。
- z を m(xr, d) とする。
- z が
failure でなければ z を返す。 - c(x) を返す。
比較例：
/a[a-z]{2,4}/.exec("abcdefghi")は
/a[a-z]{2,4}?/.exec("abcdefghi")は
また、
/(aa|aabaac|ba|b|c)*/.exec("aabaac")は選択点順序により
["aaba", "ba"]を返し、次のいずれでもない：
["aabaac", "aabaac"]
["aabaac", "c"]この選択点順序は、正規表現で2つの数（単位表記）の最大公約数を計算するためにも使える。次は10と15のgcdを計算する例：
"aaaaaaaaaa,aaaaaaaaaaaaaaa".replace(/^(a+)\1*,\1+$/, "$1")は単位表記で
RepeatMatcher の
/(a*)*/.exec("b")またはもう少し複雑な：
/(a*)b\1+/.exec("baaaac")は次の配列を返す：
["b", ""]22.2.2.3.2 EmptyMatcher ( )
抽象操作 EmptyMatcher は引数なしで呼び出され、
- 引数 (x, c) を持ち、何も捕捉せず、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- c(x) を返す。
22.2.2.3.3 MatchTwoAlternatives ( m1, m2 )
抽象操作 MatchTwoAlternatives は、引数 m1（
- 引数 (x, c) を持ち、m1 と m2
を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- r を m1(x, c) とする。
- r が
failure でなければ r を返す。 - m2(x, c) を返す。
22.2.2.3.4 MatchSequence ( m1, m2, direction )
抽象操作 MatchSequence は、引数 m1（
- もし direction が
forward なら、- 引数 (x, c) を持ち、m1 と m2
を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- d を、引数 (y) を持ち、c と
m2 を捕捉し、呼び出されたとき次を行う新しい
MatcherContinuation とする：Assert : y はMatchState である。- m2(y, c) を返す。
- m1(x, d) を返す。
- 引数 (x, c) を持ち、m1 と m2
を捕捉し、呼び出されたとき次を行う新しい
- それ以外の場合、
Assert : direction はbackward である。- 引数 (x, c) を持ち、m1 と m2
を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- d を、引数 (y) を持ち、c と
m1 を捕捉し、呼び出されたとき次を行う新しい
MatcherContinuation とする：Assert : y はMatchState である。- m1(y, c) を返す。
- m2(x, d) を返す。
22.2.2.4 実行時意味論: CompileAssertion
この節は
次の生成式ごとに分割定義される：
- 引数 (x, c) を持ち、rer を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- Input を x.[[Input]] とする。
- e を x.[[EndIndex]] とする。
- もし e = 0、または rer.[[Multiline]] が
true かつ Input[e - 1] がLineTerminator でマッチする場合、- c(x) を返す。
failure を返す。
y フラグがパターンに使われていても、^ は常に Input
の先頭、または（rer.[[Multiline]] が
- 引数 (x, c) を持ち、rer を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- Input を x.[[Input]] とする。
- e を x.[[EndIndex]] とする。
- InputLength を Input の要素数とする。
- もし e = InputLength、または rer.[[Multiline]] が
true かつ Input[e] がLineTerminator でマッチする場合、- c(x) を返す。
failure を返す。
- 引数 (x, c) を持ち、rer を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- Input を x.[[Input]] とする。
- e を x.[[EndIndex]] とする。
- a を
IsWordChar (rer, Input, e - 1) とする。 - b を
IsWordChar (rer, Input, e) とする。 - a が
true かつ b がfalse 、または a がfalse かつ b がtrue の場合、c(x) を返す。 failure を返す。
- 引数 (x, c) を持ち、rer を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- Input を x.[[Input]] とする。
- e を x.[[EndIndex]] とする。
- a を
IsWordChar (rer, Input, e - 1) とする。 - b を
IsWordChar (rer, Input, e) とする。 - a が
true かつ b がtrue 、または a がfalse かつ b がfalse の場合、c(x) を返す。 failure を返す。
- m を
CompileSubpattern （Disjunction 、引数 rer とforward ）の結果とする。 - 引数 (x, c) を持ち、m を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- d を引数 (y) を持ち、何も捕捉せず、呼び出されたとき次を行う新しい
MatcherContinuation とする：Assert : y はMatchState である。- y を返す。
- r を m(x, d) とする。
- r が
failure ならfailure を返す。 Assert : r はMatchState である。- cap を r.[[Captures]] とする。
- Input を x.[[Input]] とする。
- xe を x.[[EndIndex]] とする。
- z を
MatchState { [[Input]]: Input, [[EndIndex]]: xe, [[Captures]]: cap } とする。 - c(z) を返す。
形式 (?= )
はゼロ幅の肯定先読みを指定する。成功するには、(?=
へのバックトラックは行われない（この特殊な挙動は Perl 由来）。これは
例：
/(?=(a+))/.exec("baaabac")は最初の b 直後で空文字列にマッチし、次の配列を返す：
["", "aaa"]先読みへのバックトラックの欠如を示す例：
/(?=(a+))a*b\1/.exec("baaabac")この式は
["aba", "a"]を返し、次のものではない：
["aaaba", "a"]- m を
CompileSubpattern （Disjunction 、引数 rer とforward ）の結果とする。 - 引数 (x, c) を持ち、m を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- d を引数 (y) を持ち、何も捕捉せず、呼び出されたとき次を行う新しい
MatcherContinuation とする：Assert : y はMatchState である。- y を返す。
- r を m(x, d) とする。
- r が
failure でなければfailure を返す。 - c(x) を返す。
形式 (?! )
はゼロ幅の否定先読みを指定する。成功するには、
/(.*?)a(?!(a+)b\2c)\2(.*)/.exec("baaabaac")は「a」の直後に n 個の「a」、b、もう一度 n 個の「a」（最初の \2）と c が続かない「a」を探す。2番目の \2 は否定先読みの外にあり、常に
["baaabaac", "ba", undefined, "abaac"]- m を
CompileSubpattern （Disjunction 、引数 rer とbackward ）の結果とする。 - 引数 (x, c) を持ち、m を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- d を引数 (y) を持ち、何も捕捉せず、呼び出されたとき次を行う新しい
MatcherContinuation とする：Assert : y はMatchState である。- y を返す。
- r を m(x, d) とする。
- r が
failure ならfailure を返す。 Assert : r はMatchState である。- cap を r.[[Captures]] とする。
- Input を x.[[Input]] とする。
- xe を x.[[EndIndex]] とする。
- z を
MatchState { [[Input]]: Input, [[EndIndex]]: xe, [[Captures]]: cap } とする。 - c(z) を返す。
- m を
CompileSubpattern （Disjunction 、引数 rer とbackward ）の結果とする。 - 引数 (x, c) を持ち、m を捕捉し、呼び出されたとき次を行う新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- d を引数 (y) を持ち、何も捕捉せず、呼び出されたとき次を行う新しい
MatcherContinuation とする：Assert : y はMatchState である。- y を返す。
- r を m(x, d) とする。
- r が
failure でなければfailure を返す。 - c(x) を返す。
22.2.2.4.1 IsWordChar ( rer, Input, e )
抽象操作 IsWordChar は、引数 rer（
- InputLength を Input の要素数とする。
- もし e = -1 または e = InputLength なら
false を返す。 - c を Input[e] の文字とする。
WordCharacters (rer) が c を含む場合、true を返す。false を返す。
22.2.2.5 実行時意味論: CompileQuantifier
- qpを
CompileQuantifierPrefix （QuantifierPrefix ）とする。 Record { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]:true } を返す。
- qpを
CompileQuantifierPrefix （QuantifierPrefix ）とする。 Record { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]:false } を返す。
22.2.2.6 実行時意味論: CompileQuantifierPrefix
Record { [[Min]]: 0, [[Max]]: +∞ } を返す。
Record { [[Min]]: 1, [[Max]]: +∞ } を返す。
Record { [[Min]]: 0, [[Max]]: 1 } を返す。
- iを
DecimalDigits のMV（12.9.3 参照）とする。 Record { [[Min]]: i, [[Max]]: i } を返す。
- iを
DecimalDigits のMVとする。 Record { [[Min]]: i, [[Max]]: +∞ } を返す。
- 最初の
DecimalDigits のMVをiとする。 - 2番目の
DecimalDigits のMVをjとする。 Record { [[Min]]: i, [[Max]]: j } を返す。
22.2.2.7 実行時意味論: CompileAtom
このセクションは
次の生成規則ごとに定義される:
- chを
PatternCharacter でマッチした文字とする。 - Aを、文字chを含む1要素の
CharSet とする。 CharacterSetMatcher (rer, A,false , direction)を返す。
- Aを
AllCharacters (rer)とする。 - もしrer.[[DotAll]]が
true でない場合、- Aから
LineTerminator 生成規則の右辺に対応するコードポイントの文字をすべて除去する。
- Aから
CharacterSetMatcher (rer, A,false , direction)を返す。
- ccを
CompileCharacterClass (CharacterClass , 引数rer)とする。 - csをcc.[[CharSet]]とする。
- もしrer.[[UnicodeSets]]が
false であるか、csのすべてのCharSetElement が1文字のみで構成されている場合（csが空の場合も含む）、
CharacterSetMatcher (rer, cs, cc.[[Invert]], direction)を返す。 Assert : cc.[[Invert]]はfalse である。- lmを空の
List （Matchers のリスト）とする。 - csの各
CharSetElement s（2文字以上からなるもののみ。長さの降順で反復）について、以下を行う:- cs2をsの最後のコードポイントを含む1要素の
CharSet とする。 - m2を
CharacterSetMatcher (rer, cs2,false , direction)とする。 - sの各コードポイントc1（最後から2番目までを逆順で反復）について:
- cs1をc1のみを含む1要素の
CharSet とする。 - m1を
CharacterSetMatcher (rer, cs1,false , direction)とする。 - m2を
MatchSequence (m1, m2, direction)に更新する。
- cs1をc1のみを含む1要素の
- m2をlmに追加する。
- cs2をsの最後のコードポイントを含む1要素の
- singlesを、csのうち1文字のみからなる全ての
CharSetElement を含むCharSet とする。 CharacterSetMatcher (rer, singles,false , direction)をlmに追加する。- もしcsが空文字列を含む場合、
EmptyMatcher ()をlmに追加する。 - m2をlmの最後の
Matcher とする。 - lmの各
Matcher m1（最後から2番目までを逆順で反復）について:- m2を
MatchTwoAlternatives (m1, m2)に更新する。
- m2を
- m2を返す。
- mを
CompileSubpattern (Disjunction , 引数rerとdirection)とする。 - parenIndexを
CountLeftCapturingParensBefore (Atom )とする。 - 新しい
Matcher （パラメータ(x, c)。direction, m, parenIndexをキャプチャし、呼び出された時に以下を実行する）を返す:Assert : xはMatchState である。Assert : cはMatcherContinuation である。- dを新しい
MatcherContinuation （パラメータ(y)。x, c, direction, parenIndexをキャプチャし、呼び出された時に以下を実行する）とする:Assert : yはMatchState である。- capをy.[[Captures]]のコピーとする。
- Inputをx.[[Input]]とする。
- xeをx.[[EndIndex]]とする。
- yeをy.[[EndIndex]]とする。
- もしdirectionが
forward なら:Assert : xe ≤ yeである。- rを
CaptureRange { [[StartIndex]]: xe, [[EndIndex]]: ye }とする。
- それ以外の場合:
Assert : directionはbackward である。Assert : ye ≤ xeである。- rを
CaptureRange { [[StartIndex]]: ye, [[EndIndex]]: xe }とする。
- cap[parenIndex + 1]にrをセットする。
- zを
MatchState { [[Input]]: Input, [[EndIndex]]: ye, [[Captures]]: cap }とする。 - c(z)を返す。
- m(x, d)を返す。
( )の括弧は、\）、置換文字列による参照、または正規表現マッチング(?:
)の形式を使うこと。
- addModifiersを
マッチしたソーステキスト RegularExpressionModifiers とする。 - removeModifiersを空文字列とする。
- modifiedRerを
UpdateModifiers (rer,CodePointsToString (addModifiers), removeModifiers)とする。 CompileSubpattern (Disjunction , 引数modifiedRerおよびdirection)を返す。
- addModifiersを
マッチしたソーステキスト 最初のRegularExpressionModifiers とする。 - removeModifiersを
マッチしたソーステキスト 2番目のRegularExpressionModifiers とする。 - modifiedRerを
UpdateModifiers (rer,CodePointsToString (addModifiers),CodePointsToString (removeModifiers))とする。 CompileSubpattern (Disjunction , 引数modifiedRerとdirection)を返す。
- nを
CapturingGroupNumber (DecimalEscape )とする。 Assert : n ≤ rer.[[CapturingGroupsCount]]である。BackreferenceMatcher (rer, « n », direction)を返す。
バックスラッシュと非ゼロの10進数nの形式のエスケープシーケンスは、n番目のキャプチャ括弧の結果にマッチする（
- cvを
CharacterValue (CharacterEscape )とする。 - chを文字値がcvである文字とする。
- Aを文字chを含む1要素の
CharSet とする。 CharacterSetMatcher (rer, A,false , direction)を返す。
- csを
CompileToCharSet (CharacterClassEscape , 引数rer)とする。 - もしrer.[[UnicodeSets]]が
false であるか、csのすべてのCharSetElement が1文字のみからなる場合（空の場合も含む）、
CharacterSetMatcher (rer, cs,false , direction)を返す。 - lmを空の
List （Matchers のリスト）とする。 - csの各
CharSetElement s（2文字以上からなるもののみ。長さの降順で反復）について、以下を行う:- cs2をsの最後のコードポイントを含む1要素の
CharSet とする。 - m2を
CharacterSetMatcher (rer, cs2,false , direction)とする。 - sの各コードポイントc1（最後から2番目までを逆順で反復）について:
- cs1をc1のみを含む1要素の
CharSet とする。 - m1を
CharacterSetMatcher (rer, cs1,false , direction)とする。 - m2を
MatchSequence (m1, m2, direction)に更新する。
- cs1をc1のみを含む1要素の
- m2をlmに追加する。
- cs2をsの最後のコードポイントを含む1要素の
- singlesを、csのうち1文字のみからなる全ての
CharSetElement を含むCharSet とする。 CharacterSetMatcher (rer, singles,false , direction)をlmに追加する。- もしcsが空文字列を含む場合、
EmptyMatcher ()をlmに追加する。 - m2をlmの最後の
Matcher とする。 - lmの各
Matcher m1（最後から2番目までを逆順で反復）について:- m2を
MatchTwoAlternatives (m1, m2)に更新する。
- m2を
- m2を返す。
- matchingGroupSpecifiersを
GroupSpecifiersThatMatch (GroupName )とする。 - parenIndicesを新しい空の
List とする。 - matchingGroupSpecifiersの各
GroupSpecifier groupSpecifierについて:- parenIndexを
CountLeftCapturingParensBefore (groupSpecifier)とする。 - parenIndexをparenIndicesに追加する。
- parenIndexを
BackreferenceMatcher (rer, parenIndices, direction)を返す。
22.2.2.7.1 CharacterSetMatcher ( rer, A, invert, direction )
抽象演算CharacterSetMatcherは、引数rer（
- もしrer.[[UnicodeSets]]が
true なら、Assert : invertはfalse である。Assert : AのすべてのCharSetElement は 1文字のみからなる。
- 新しい
Matcher （パラメータ (x, c)。rer, A, invert, directionをキャプチャし、呼び出された時以下を実行）を返す:Assert : xはMatchState である。Assert : cはMatcherContinuation である。- Inputをx.[[Input]]とする。
- eをx.[[EndIndex]]とする。
- もしdirectionが
forward なら、f = e + 1とする。 - それ以外の場合、f = e - 1とする。
- InputLengthをInputの要素数とする。
- もしf < 0 または f > InputLengthなら、
failure を返す。 - indexを
min (e, f)とする。 - chをInput[index]の文字とする。
- ccを
Canonicalize (rer, ch)とする。 - もしA内に、ちょうど1文字aのみを含み、かつ
Canonicalize (rer, a)がccとなるCharSetElement が存在する場合、 found =true とする。そうでなければfound =false とする。 - invertが
false かつfoundがfalse なら、failure を返す。 - invertが
true かつfoundがtrue なら、failure を返す。 - capをx.[[Captures]]とする。
- yを
MatchState { [[Input]]: Input, [[EndIndex]]: f, [[Captures]]: cap }とする。 - c(y)を返す。
22.2.2.7.2 BackreferenceMatcher ( rer, ns, direction )
抽象演算BackreferenceMatcherは、引数rer（
- 新しい
Matcher （パラメータ (x, c)。rer, ns, directionをキャプチャし、呼び出された時以下を実行）を返す:Assert : xはMatchState である。Assert : cはMatcherContinuation である。- Inputをx.[[Input]]とする。
- capをx.[[Captures]]とする。
- rを
undefined とする。 - nsの各
integer nについて:- もしcap[n]が
undefined でなければ、Assert : rはundefined である。- rをcap[n]にセットする。
- もしcap[n]が
- もしrが
undefined なら、c(x)を返す。 - eをx.[[EndIndex]]とする。
- rsをr.[[StartIndex]]とする。
- reをr.[[EndIndex]]とする。
- lenをre - rsとする。
- もしdirectionが
forward なら、f = e + lenとする。 - それ以外の場合、f = e - lenとする。
- InputLengthをInputの要素数とする。
- もしf < 0 または f > InputLengthなら、
failure を返す。 - gを
min (e, f)とする。 - もし0（含む）からlen（含まない）までの範囲の
integer iが存在し、Canonicalize (rer, Input[rs + i])がCanonicalize (rer, Input[g + i])と一致しない場合、failure を返す。 - yを
MatchState { [[Input]]: Input, [[EndIndex]]: f, [[Captures]]: cap }とする。 - c(y)を返す。
22.2.2.7.3 Canonicalize ( rer, ch )
抽象演算Canonicalizeは、引数rer（
HasEitherUnicodeFlag (rer) がtrue かつrer.[[IgnoreCase]]がtrue なら、- Unicode Character Databaseの
CaseFolding.txtファイルがchに対する単純または共通のケースフォールディングマッピングを提供する場合は、そのマッピングを適用して得られた結果を返す。 - chを返す。
- Unicode Character Databaseの
- rer.[[IgnoreCase]]が
false なら、chを返す。 Assert : chはUTF-16コードユニットである。- cpをchの数値と同じ数値のコードポイントとする。
- uをUnicode Default Case Conversionアルゴリズムに従い、toUppercase(« cp »)とする。
- uStrを
CodePointsToString (u)とする。 - uStrの長さが1でない場合、chを返す。
- cuをuStrの唯一のコードユニット要素とする。
- chの数値が128以上かつcuの数値が128未満の場合、chを返す。
- cuを返す。
大文字・小文字を区別しないマッチでß（U+00DF）はssやSSにはマップされない。ただし、Basic
Latinブロック外のコードポイントが内側にマップされる場合がある（例:ſ（U+017F）はs（U+0073）へ、K（U+212A）はk（U+006B）へ）。これらのコードポイントを含む文字列は/[a-z]/uiなどの正規表現でマッチする。
大文字・小文字を区別しないマッチでΩ（U+2126）はtoUppercaseでは自身に、toCasefoldではω（U+03C9）とΩ（U+03A9）になる。したがって、/[ω]/uiや/[\u03A9]/uiではマッチするが、/[ω]/iや/[\u03A9]/iではマッチしない。また、Basic
Latinブロック外のコードポイントが内側にマップされることはないため、/[a-z]/iでマッチしない。
22.2.2.7.4 UpdateModifiers ( rer, add, remove )
抽象演算UpdateModifiersは、引数rer（
Assert : addと removeは共通の要素を持たない。- ignoreCaseをrer.[[IgnoreCase]]とする。
- multilineをrer.[[Multiline]]とする。
- dotAllをrer.[[DotAll]]とする。
- unicodeをrer.[[Unicode]]とする。
- unicodeSetsをrer.[[UnicodeSets]]とする。
- capturingGroupsCountをrer.[[CapturingGroupsCount]]とする。
- removeが
"i" を含む場合、ignoreCase =false とする。 - それ以外でaddが
"i" を含む場合、ignoreCase =true とする。 - removeが
"m" を含む場合、multiline =false とする。 - それ以外でaddが
"m" を含む場合、multiline =true とする。 - removeが
"s" を含む場合、dotAll =false とする。 - それ以外でaddが
"s" を含む場合、dotAll =true とする。 RegExp Record { [[IgnoreCase]]: ignoreCase, [[Multiline]]: multiline, [[DotAll]]: dotAll, [[Unicode]]: unicode, [[UnicodeSets]]: unicodeSets, [[CapturingGroupsCount]]: capturingGroupsCount }を返す。
22.2.2.8 実行時意味論: CompileCharacterClass
- Aを
CompileToCharSet (ClassContents , 引数rer)とする。 Record { [[CharSet]]: A, [[Invert]]:false } を返す。
- Aを
CompileToCharSet (ClassContents , 引数rer)とする。 - もしrer.[[UnicodeSets]]が
true なら:Record { [[CharSet]]:CharacterComplement (rer, A), [[Invert]]:false } を返す。
Record { [[CharSet]]: A, [[Invert]]:true } を返す。
22.2.2.9 実行時意味論: CompileToCharSet
このセクションは
次の生成規則ごとに定義される:
- 空の
CharSet を返す。
- Aを
CompileToCharSet (ClassAtom , 引数rer)とする。 - Bを
CompileToCharSet (NonemptyClassRangesNoDash , 引数rer)とする。 CharSets AとBの和集合を返す。
- 最初の
ClassAtom について、AをCompileToCharSet (..., 引数rer)とする。 - 2番目の
ClassAtom について、BをCompileToCharSet (..., 引数rer)とする。 - Cを
CompileToCharSet (ClassContents , 引数rer)とする。 - Dを
CharacterRange (A, B)とする。 - DとCの和集合を返す。
- Aを
CompileToCharSet (ClassAtomNoDash , 引数rer)とする。 - Bを
CompileToCharSet (NonemptyClassRangesNoDash , 引数rer)とする。 CharSets AとBの和集合を返す。
- Aを
CompileToCharSet (ClassAtomNoDash , 引数rer)とする。 - Bを
CompileToCharSet (ClassAtom , 引数rer)とする。 - Cを
CompileToCharSet (ClassContents , 引数rer)とする。 - Dを
CharacterRange (A, B)とする。 - DとCの和集合を返す。
パターンが大文字小文字を無視していても、範囲の両端の大文字小文字は範囲に含まれる文字の判定に影響する。例えば、/[E-F]/iはE,
F, e, fのみをマッチし、/[E-f]/iはUnicode
Basic Latin blockの全大文字・小文字英字と記号[, \, ],
^, _, `もマッチする。
-文字はリテラルとしても範囲指定としても扱える。
- 文字
-U+002D（HYPHEN-MINUS）を含むCharSet を返す。
CharSet （SourceCharacter でマッチした文字を含む）を返す。
- cvを
CharacterValue (このClassEscape )とする。 - cを文字値cvを持つ文字とする。
- cのみを含む
CharSet を返す。
\b、\B、バックリファレンスは除く。\bはバックスペース文字、\Bとバックリファレンスはエラーとなる。バックリファレンスを
- 10個の文字
0,1,2,3,4,5,6,7,8,9を含むCharSet を返す。
- Sを下記の
CharSet （CharacterClassEscape :: d CharacterComplement (rer, S)を返す。
CharSet （WhiteSpace またはLineTerminator 生成規則の右辺に対応するコードポイントの全ての文字を含む）を返す。
- Sを下記の
CharSet （CharacterClassEscape :: s CharacterComplement (rer, S)を返す。
MaybeSimpleCaseFolding (rer,WordCharacters (rer))を返す。
- Sを下記の
CharSet （CharacterClassEscape :: w CharacterComplement (rer, S)を返す。
CompileToCharSet (UnicodePropertyValueExpression , 引数rer)を返す。
- Sを
CompileToCharSet (UnicodePropertyValueExpression , 引数rer)とする。 Assert : Sは単一コードポイントのみを含む。CharacterComplement (rer, S)を返す。
- psを
マッチしたソーステキスト (UnicodePropertyName )とする。 - pを
UnicodeMatchProperty (rer, ps)とする。 Assert : pはUnicodeproperty name または表69 の「Property name とエイリアス」列に記載されたプロパティエイリアスである。- vsを
マッチしたソーステキスト (UnicodePropertyValue )とする。 - vを
UnicodeMatchPropertyValue (p, vs)とする。 - Aを、プロパティpの値vがUnicode文字データベース定義に含まれる全てのUnicodeコードポイントを含む
CharSet とする。 MaybeSimpleCaseFolding (rer, A)を返す。
- sを
マッチしたソーステキスト (LoneUnicodePropertyNameOrValue )とする。 UnicodeMatchPropertyValue (General_Category, s)がPropertyValueAliases.txtに記載されたGeneral_Category（gc）プロパティのUnicodeプロパティ値または値エイリアスであれば:- プロパティ“General_Category”の値sがUnicode文字データベース定義に含まれる全てのUnicodeコードポイントを含む
CharSet を返す。
- プロパティ“General_Category”の値sがUnicode文字データベース定義に含まれる全てのUnicodeコードポイントを含む
- pを
UnicodeMatchProperty (rer, s)とする。 Assert : pは表70 の「Property nameとエイリアス」列に記載されたバイナリUnicodeプロパティまたはエイリアス、あるいは表71 の「Property name」列に記載された文字列のバイナリUnicodeプロパティである。- Aを、プロパティpの値“True”が文字データベース定義に含まれる全てのCharSetElementを含む
CharSet とする。 MaybeSimpleCaseFolding (rer, A)を返す。
- Aを
CompileToCharSet (ClassSetRange , 引数rer)とする。 ClassUnion が存在する場合、- Bを
CompileToCharSet (ClassUnion , 引数rer)とする。 CharSets AとBの和集合を返す。
- Bを
- Aを返す。
- Aを
CompileToCharSet (ClassSetOperand , 引数rer)とする。 ClassUnion が存在する場合、- Bを
CompileToCharSet (ClassUnion , 引数rer)とする。 CharSets AとBの和集合を返す。
- Bを
- Aを返す。
- 最初の
ClassSetOperand について、AをCompileToCharSet (..., 引数rer)とする。 - 2番目の
ClassSetOperand について、BをCompileToCharSet (..., 引数rer)とする。 CharSets AとBの積集合を返す。
- Aを
CompileToCharSet (ClassIntersection , 引数rer)とする。 - Bを
CompileToCharSet (ClassSetOperand , 引数rer)とする。 CharSets AとBの積集合を返す。
- 最初の
ClassSetOperand について、AをCompileToCharSet (..., 引数rer)とする。 - 2番目の
ClassSetOperand について、BをCompileToCharSet (..., 引数rer)とする。 CharSet （AのCharSetElementのうちBのCharSetElementでないものを含む）を返す。
- Aを
CompileToCharSet (ClassSubtraction , 引数rer)とする。 - Bを
CompileToCharSet (ClassSetOperand , 引数rer)とする。 CharSet （AのCharSetElementのうちBのCharSetElementでないものを含む）を返す。
- 最初の
ClassSetCharacter について、AをCompileToCharSet (..., 引数rer)とする。 - 2番目の
ClassSetCharacter について、BをCompileToCharSet (..., 引数rer)とする。 MaybeSimpleCaseFolding (rer,CharacterRange (A, B))を返す。
結果はしばしば2つ以上の範囲からなる。UnicodeSetsが
- Aを
CompileToCharSet (ClassSetCharacter , 引数rer)とする。 MaybeSimpleCaseFolding (rer, A)を返す。
- Aを
CompileToCharSet (ClassStringDisjunction , 引数rer)とする。 MaybeSimpleCaseFolding (rer, A)を返す。
CompileToCharSet (NestedClass , 引数rer)を返す。
CompileToCharSet (ClassContents , 引数rer)を返す。
- Aを
CompileToCharSet (ClassContents , 引数rer)とする。 CharacterComplement (rer, A)を返す。
CompileToCharSet (CharacterClassEscape , 引数rer)を返す。
CompileToCharSet (ClassStringDisjunctionContents , 引数rer)を返す。
- sを
CompileClassSetString (ClassString , 引数rer)とする。 - 文字列sのみを含む
CharSet を返す。
- sを
CompileClassSetString (ClassString , 引数rer)とする。 - 文字列sのみを含む
CharSet をAとする。 - Bを
CompileToCharSet (ClassStringDisjunctionContents , 引数rer)とする。 CharSets AとBの和集合を返す。
- cvを、この
ClassSetCharacter のCharacterValue とする。 - cを文字値がcvである文字とする。
- cのみを含む
CharSet を返す。
- U+0008（BACKSPACE）のみを含む
CharSet を返す。
22.2.2.9.1 CharacterRange ( A, B )
抽象演算CharacterRangeは、引数A（
22.2.2.9.2 HasEitherUnicodeFlag ( rer )
抽象演算HasEitherUnicodeFlagは、引数rer（
- rer.[[Unicode]]が
true 、またはrer.[[UnicodeSets]]がtrue なら、true を返す。
false を返す。
22.2.2.9.3 WordCharacters ( rer )
抽象演算WordCharactersは、引数rer（\b、\B、\w、\Wにおいて「単語文字」とされる文字を含む
- basicWordCharsを
CharSet （ASCII単語文字 の全ての文字を含む）とする。 - extraWordCharsを、全ての文字cについて、cがbasicWordCharsに含まれておらず、
Canonicalize (rer, c)がbasicWordCharsに含まれる場合にそのcだけを含むCharSet とする。 Assert : extraWordCharsは、HasEitherUnicodeFlag (rer) がtrue かつrer.[[IgnoreCase]]がtrue でない限り、空である。- basicWordCharsとextraWordCharsの和集合を返す。
22.2.2.9.4 AllCharacters ( rer )
抽象演算AllCharactersは、引数rer（
- rer.[[UnicodeSets]]が
true かつrer.[[IgnoreCase]]がtrue なら: - それ以外で
HasEitherUnicodeFlag (rer) がtrue なら:CharSet （全コードポイント値を含む）を返す。
- それ以外の場合:
CharSet （全コードユニット値を含む）を返す。
22.2.2.9.5 MaybeSimpleCaseFolding ( rer, A )
抽象演算MaybeSimpleCaseFoldingは、引数rer（CaseFolding.txtを使い、Aの各
- rer.[[UnicodeSets]]が
false またはrer.[[IgnoreCase]]がfalse なら、Aを返す。 - Bを新しい空の
CharSet とする。 - Aの各
CharSetElement sについて:- tを空の文字列列とする。
- sの各単一コードポイントcpについて:
scf (cp)をtに追加する。
- tをBに追加する。
- Bを返す。
22.2.2.9.6 CharacterComplement ( rer, S )
抽象演算CharacterComplementは、引数rer（
- Aを
AllCharacters (rer)とする。 - AのCharSetElementのうちSのCharSetElementでないものを含む
CharSet を返す。
22.2.2.9.7 UnicodeMatchProperty ( rer, p )
抽象演算UnicodeMatchPropertyは、引数rer（
実装は、
例えば、Script_Extensions（scx（プロパティエイリアス）は有効だが、script_extensionsやScxは有効ではない。
これらのプロパティは、UTS18 RL1.2が要求するもののスーパーセットである。
これらの表の項目（大文字小文字等を含む）の綴りは、Unicode Character DatabaseのPropertyAliases.txtファイルで使われている綴りと一致する。そのファイルの正確な綴りは安定性が保証されている。
| 正規 |
|
|---|---|
General_Category |
General_Category
|
gc |
|
Script |
Script
|
sc |
|
Script_Extensions |
Script_Extensions
|
scx |
| 正規 |
|
|---|---|
ASCII |
ASCII
|
ASCII_Hex_Digit |
ASCII_Hex_Digit
|
AHex |
|
Alphabetic |
Alphabetic
|
Alpha |
|
Any |
Any
|
Assigned |
Assigned
|
Bidi_Control |
Bidi_Control
|
Bidi_C |
|
Bidi_Mirrored |
Bidi_Mirrored
|
Bidi_M |
|
Case_Ignorable |
Case_Ignorable
|
CI |
|
Cased |
Cased
|
Changes_When_Casefolded |
Changes_When_Casefolded
|
CWCF |
|
Changes_When_Casemapped |
Changes_When_Casemapped
|
CWCM |
|
Changes_When_Lowercased |
Changes_When_Lowercased
|
CWL |
|
Changes_When_NFKC_Casefolded |
Changes_When_NFKC_Casefolded
|
CWKCF |
|
Changes_When_Titlecased |
Changes_When_Titlecased
|
CWT |
|
Changes_When_Uppercased |
Changes_When_Uppercased
|
CWU |
|
Dash |
Dash
|
Default_Ignorable_Code_Point |
Default_Ignorable_Code_Point
|
DI |
|
Deprecated |
Deprecated
|
Dep |
|
Diacritic |
Diacritic
|
Dia |
|
Emoji |
Emoji
|
Emoji_Component |
Emoji_Component
|
EComp |
|
Emoji_Modifier |
Emoji_Modifier
|
EMod |
|
Emoji_Modifier_Base |
Emoji_Modifier_Base
|
EBase |
|
Emoji_Presentation |
Emoji_Presentation
|
EPres |
|
Extended_Pictographic |
Extended_Pictographic
|
ExtPict |
|
Extender |
Extender
|
Ext |
|
Grapheme_Base |
Grapheme_Base
|
Gr_Base |
|
Grapheme_Extend |
Grapheme_Extend
|
Gr_Ext |
|
Hex_Digit |
Hex_Digit
|
Hex |
|
IDS_Binary_Operator |
IDS_Binary_Operator
|
IDSB |
|
IDS_Trinary_Operator |
IDS_Trinary_Operator
|
IDST |
|
ID_Continue |
ID_Continue
|
IDC |
|
ID_Start |
ID_Start
|
IDS |
|
Ideographic |
Ideographic
|
Ideo |
|
Join_Control |
Join_Control
|
Join_C |
|
Logical_Order_Exception |
Logical_Order_Exception
|
LOE |
|
Lowercase |
Lowercase
|
Lower |
|
Math |
Math
|
Noncharacter_Code_Point |
Noncharacter_Code_Point
|
NChar |
|
Pattern_Syntax |
Pattern_Syntax
|
Pat_Syn |
|
Pattern_White_Space |
Pattern_White_Space
|
Pat_WS |
|
Quotation_Mark |
Quotation_Mark
|
QMark |
|
Radical |
Radical
|
Regional_Indicator |
Regional_Indicator
|
RI |
|
Sentence_Terminal |
Sentence_Terminal
|
STerm |
|
Soft_Dotted |
Soft_Dotted
|
SD |
|
Terminal_Punctuation |
Terminal_Punctuation
|
Term |
|
Unified_Ideograph |
Unified_Ideograph
|
UIdeo |
|
Uppercase |
Uppercase
|
Upper |
|
Variation_Selector |
Variation_Selector
|
VS |
|
White_Space |
White_Space
|
space |
|
XID_Continue |
XID_Continue
|
XIDC |
|
XID_Start |
XID_Start
|
XIDS |
Basic_Emoji |
Emoji_Keycap_Sequence |
RGI_Emoji_Modifier_Sequence |
RGI_Emoji_Flag_Sequence |
RGI_Emoji_Tag_Sequence |
RGI_Emoji_ZWJ_Sequence |
RGI_Emoji |
22.2.2.9.8 UnicodeMatchPropertyValue ( p, v )
抽象演算UnicodeMatchPropertyValueは、引数p（
実装は、PropertyValueAliases.txtに記載されたUnicodeプロパティ値と値エイリアスをサポートしなければならない。相互運用性を確保するため、これら以外のプロパティ値や値エイリアスはサポートしてはならない。
例えば、XpeoやOld_Persianは有効なScript_Extensions値だが、xpeoやOld Persianは有効ではない。
このアルゴリズムはUAX44に記載された記号値のマッチング規則とは異なり、大文字小文字、Isプレフィックスもサポートされない。
22.2.2.10 実行時意味論: CompileClassSetString
- 空の文字列列を返す。
CompileClassSetString (NonEmptyClassString , 引数rer)の返り値を返す。
- csを
CompileToCharSet (ClassSetCharacter , 引数rer)とする。 - s1をcsの唯一の
CharSetElement である文字列列とする。 NonEmptyClassString が存在する場合、- s2を
CompileClassSetString (NonEmptyClassString , 引数rer)とする。 - s1とs2を連結したものを返す。
- s2を
- s1を返す。
22.2.3 RegExp生成のための抽象演算
22.2.3.1 RegExpCreate ( P, F )
抽象演算RegExpCreateは、引数P（
- objを!
RegExpAlloc (%RegExp% )とする。 - ?
RegExpInitialize (obj, P, F)を返す。
22.2.3.2 RegExpAlloc ( newTarget )
抽象演算RegExpAllocは引数newTarget（
- objを?
OrdinaryCreateFromConstructor (newTarget,"%RegExp.prototype%" , « [[OriginalSource]], [[OriginalFlags]], [[RegExpRecord]], [[RegExpMatcher]] » )とする。 - !
DefinePropertyOrThrow (obj,"lastIndex" , PropertyDescriptor { [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false } ) を実行する。 - objを返す。
22.2.3.3 RegExpInitialize ( obj, pattern, flags )
抽象演算RegExpInitializeは、引数obj（オブジェクト）、pattern（
- patternが
undefined なら、Pを空文字列とする。 - そうでなければ、Pを?
ToString (pattern)とする。 - flagsが
undefined なら、Fを空文字列とする。 - そうでなければ、Fを?
ToString (flags)とする。 - Fが
"d" ,"g" ,"i" ,"m" ,"s" ,"u" ,"v" ,"y" 以外のコードユニットを含む場合、またはFが同じコードユニットを複数回含む場合、SyntaxError 例外をthrowする。 - Fが
"i" を含むなら、iをtrue とし、そうでなければiをfalse とする。 - Fが
"m" を含むなら、mをtrue とし、そうでなければmをfalse とする。 - Fが
"s" を含むなら、sをtrue とし、そうでなければsをfalse とする。 - Fが
"u" を含むなら、uをtrue とし、そうでなければuをfalse とする。 - Fが
"v" を含むなら、vをtrue とし、そうでなければvをfalse とする。 - uが
true またはvがtrue なら:- patternTextを
StringToCodePoints (P)とする。
- patternTextを
- そうでなければ:
- patternTextをPの各16ビット要素をUnicode BMPコードポイントとして解釈した結果とする。UTF-16デコードは適用しない。
- parseResultを
ParsePattern (patternText, u, v)とする。 - parseResultが
List で非空かつSyntaxError オブジェクトを含む場合は、SyntaxError 例外をthrowする。 Assert : parseResultはPattern Parse Node である。- obj.[[OriginalSource]]にPを設定する。
- obj.[[OriginalFlags]]にFを設定する。
- capturingGroupsCountを
CountLeftCapturingParensWithin (parseResult)とする。 - rerを
RegExp Record { [[IgnoreCase]]: i, [[Multiline]]: m, [[DotAll]]: s, [[Unicode]]: u, [[UnicodeSets]]: v, [[CapturingGroupsCount]]: capturingGroupsCount }とする。 - obj.[[RegExpRecord]]にrerを設定する。
- obj.[[RegExpMatcher]]に
CompilePattern (parseResult, rer)を設定する。 - ?
Set (obj,"lastIndex" ,+0 𝔽,true )を実行する。 - objを返す。
22.2.3.4 静的セマンティクス: ParsePattern ( patternText, u, v )
抽象演算ParsePatternは、引数patternText（Unicodeコードポイント列）、u（Boolean）、v（Boolean）を受け取り、
このセクションは
呼び出されたときは以下の手順を実行する:
- vが
true かつuがtrue なら:- parseResultを
List （1個以上のSyntaxError オブジェクトを含む）とする。
- parseResultを
- そうでなければvが
true なら: - そうでなければuが
true なら: - それ以外の場合:
- parseResultを返す。
22.2.4 RegExpコンストラクタ
RegExp
- %RegExp%である。
グローバルオブジェクト の"RegExp" プロパティの初期値である。コンストラクタ として呼び出された場合、新しいRegExpオブジェクトを作成し初期化する。- 関数として呼び出された場合（
コンストラクタ としてではなく）、新しいRegExpオブジェクトを返すか、引数がRegExpオブジェクトのみの場合はその引数自体を返す。 - クラス定義の
extends句の値として使用できる。指定されたRegExpの動作を継承するサブクラスコンストラクタ は、必要な内部スロットでサブクラスインスタンスを作成・初期化するためにRegExpコンストラクタ へのsuper呼び出しを含めなければならない。
22.2.4.1 RegExp ( pattern, flags )
この関数は呼び出された時、以下の手順を実行する:
- patternIsRegExpを?
IsRegExp (pattern)とする。 - NewTargetが
undefined なら:- newTargetを
アクティブ関数オブジェクト とする。 - patternIsRegExpが
true かつflagsがundefined なら:
- newTargetを
- それ以外の場合:
- newTargetをNewTargetとする。
- patternが
オブジェクトである かつpatternが[[RegExpMatcher]]内部スロットを持つ場合:- Pをpattern.[[OriginalSource]]とする。
- flagsが
undefined なら、Fをpattern.[[OriginalFlags]]とする。 - それ以外の場合、Fをflagsとする。
- それ以外でpatternIsRegExpが
true なら: - それ以外の場合:
- Pをpatternとする。
- Fをflagsとする。
- Oを?
RegExpAlloc (newTarget)とする。 - ?
RegExpInitialize (O, P, F)を返す。
patternが
22.2.5 RegExpコンストラクタのプロパティ
RegExp
- [[Prototype]]内部スロットがあり、その値は
%Function.prototype% である。 - 以下のプロパティを持つ。
22.2.5.1 RegExp.escape ( S )
この関数は、正規表現
呼び出された時は以下の手順を実行する:
- Sが
文字列でない場合 、TypeError 例外をthrowする。 - escapedを空文字列とする。
- cpListを
StringToCodePoints (S)とする。 - cpListの各コードポイントcpについて、以下を行う:
- escapedが空文字列であり、かつcpが
DecimalDigit またはAsciiLetter にマッチする場合:- 注: 先頭の数字をエスケープすることで、
\0文字エスケープやDecimalEscape （例:\1）の後にパターンテキストとして使用されてもSとして一致し、直前のエスケープシーケンスの拡張と解釈されないようになる。先頭のASCII文字をエスケープすることも\cの後のコンテキストで同様の効果を持つ。 - numericValueをcpの数値値とする。
- hexを
Number::toString (𝔽 (numericValue), 16)とする。 Assert : hexの長さは2である。- escapedにコードユニット0x005C（バックスラッシュ）、
"x" 、hexを連結 したものを設定する。
- 注: 先頭の数字をエスケープすることで、
- それ以外の場合:
- escapedにescapedと
EncodeForRegExpEscape (cp)を連結 したものを設定する。
- escapedにescapedと
- escapedが空文字列であり、かつcpが
- escapedを返す。
名称は似ているが、RegExp.escapeは同様の動作はしない。前者はパターンを文字列として表現するためにエスケープし、この関数は文字列をパターン内で表現するためにエスケープする。
22.2.5.1.1 EncodeForRegExpEscape ( cp )
抽象演算EncodeForRegExpEscapeは引数cp（コードポイント）を受け取り、文字列を返す。cpにマッチする
- cpが
SyntaxCharacter にマッチするか、またはcpがU+002F（スラッシュ）の場合:- コードユニット0x005C（バックスラッシュ）と
UTF16EncodeCodePoint (cp)を連結 したものを返す。
- コードユニット0x005C（バックスラッシュ）と
- それ以外で、cpが
表67 の「Code Point」列に記載されている場合:- コードユニット0x005C（バックスラッシュ）と、その行の「ControlEscape」列の文字列を
連結 したものを返す。
- コードユニット0x005C（バックスラッシュ）と、その行の「ControlEscape」列の文字列を
- otherPunctuatorsを
連結 した",-=<>#&!%:;@~'`" とコードユニット0x0022（引用符）とする。 - toEscapeを
StringToCodePoints (otherPunctuators)とする。 - toEscapeがcpを含む場合、cpが
WhiteSpace またはLineTerminator にマッチする場合、またはcpがリーディングサロゲート またはトレーリングサロゲート と同じ数値値を持つ場合:- cpNumをcpの数値値とする。
- cpNum ≤ 0xFF の場合:
- hexを
Number::toString (𝔽 (cpNum), 16)とする。 - コードユニット0x005C（バックスラッシュ）、
"x" 、StringPad (hex, 2,"0" ,start )を連結 したものを返す。
- hexを
- escapedを空文字列とする。
- codeUnitsを
UTF16EncodeCodePoint (cp)とする。 - codeUnitsの各コードユニットcuについて:
- escapedにescapedと
UnicodeEscape (cu)を連結 したものを設定する。
- escapedにescapedと
- escapedを返す。
UTF16EncodeCodePoint (cp)を返す。
22.2.5.2 RegExp.prototype
RegExp.prototypeの初期値は
このプロパティは{ [[Writable]]:
22.2.5.3 get RegExp [ %Symbol.species% ]
RegExp[%Symbol.species%]は
this 値を返す。
この関数の
RegExpプロトタイプメソッドは通常、
22.2.6 RegExpプロトタイプオブジェクトのプロパティ
RegExpプロトタイプオブジェクト:
- %RegExp.prototype%である。
通常のオブジェクト である。- RegExpインスタンスではなく、[[RegExpMatcher]]内部スロットやRegExpインスタンスオブジェクトの他の内部スロットを持たない。
- [[Prototype]]内部スロットがあり、その値は
%Object.prototype% である。
RegExpプロトタイプオブジェクトは自身の
22.2.6.1 RegExp.prototype.constructor
RegExp.prototype.constructorの初期値は
22.2.6.2 RegExp.prototype.exec ( string )
このメソッドはstring内で正規表現パターンの出現を検索し、一致した結果を含む配列を返す。一致しなければ
呼び出された時は以下の手順を実行する:
- Rを
this 値とする。 - ?
RequireInternalSlot (R, [[RegExpMatcher]])を実行する。 - Sを?
ToString (string)とする。 - ?
RegExpBuiltinExec (R, S)を返す。
22.2.6.3 get RegExp.prototype.dotAll
RegExp.prototype.dotAllは
- Rを
this 値とする。 - cuをコードユニット0x0073（小文字s）とする。
- ?
RegExpHasFlag (R, cu)を返す。
22.2.6.4 get RegExp.prototype.flags
RegExp.prototype.flagsは
- Rを
this 値とする。 - Rが
オブジェクトでない場合 、TypeError 例外をthrowする。 - codeUnitsを新しい空の
List とする。 - hasIndicesを
ToBoolean (?Get (R,"hasIndices" ))とする。 - hasIndicesが
true なら、コードユニット0x0064（小文字d）をcodeUnitsに追加する。 - globalを
ToBoolean (?Get (R,"global" ))とする。 - globalが
true なら、コードユニット0x0067（小文字g）をcodeUnitsに追加する。 - ignoreCaseを
ToBoolean (?Get (R,"ignoreCase" ))とする。 - ignoreCaseが
true なら、コードユニット0x0069（小文字i）をcodeUnitsに追加する。 - multilineを
ToBoolean (?Get (R,"multiline" ))とする。 - multilineが
true なら、コードユニット0x006D（小文字m）をcodeUnitsに追加する。 - dotAllを
ToBoolean (?Get (R,"dotAll" ))とする。 - dotAllが
true なら、コードユニット0x0073（小文字s）をcodeUnitsに追加する。 - unicodeを
ToBoolean (?Get (R,"unicode" ))とする。 - unicodeが
true なら、コードユニット0x0075（小文字u）をcodeUnitsに追加する。 - unicodeSetsを
ToBoolean (?Get (R,"unicodeSets" ))とする。 - unicodeSetsが
true なら、コードユニット0x0076（小文字v）をcodeUnitsに追加する。 - stickyを
ToBoolean (?Get (R,"sticky" ))とする。 - stickyが
true なら、コードユニット0x0079（小文字y）をcodeUnitsに追加する。 - codeUnitsの要素からなる文字列値を返す。codeUnitsに要素がなければ空文字列を返す。
22.2.6.4.1 RegExpHasFlag ( R, codeUnit )
抽象演算RegExpHasFlagは引数R（
- Rが
オブジェクトでない場合 、TypeError 例外をthrowする。 - Rが[[OriginalFlags]]内部スロットを持たない場合:
SameValue (R,%RegExp.prototype% ) がtrue なら、undefined を返す。- それ以外の場合、
TypeError 例外をthrowする。
- flagsをR.[[OriginalFlags]]とする。
- flagsがcodeUnitを含む場合、
true を返す。 false を返す。
22.2.6.5 get RegExp.prototype.global
RegExp.prototype.globalは
- Rを
this 値とする。 - cuをコードユニット0x0067（小文字g）とする。
- ?
RegExpHasFlag (R, cu)を返す。
22.2.6.6 get RegExp.prototype.hasIndices
RegExp.prototype.hasIndicesは
- Rを
this 値とする。 - cuをコードユニット0x0064（小文字d）とする。
- ?
RegExpHasFlag (R, cu)を返す。
22.2.6.7 get RegExp.prototype.ignoreCase
RegExp.prototype.ignoreCaseは
- Rを
this 値とする。 - cuをコードユニット0x0069（小文字i）とする。
- ?
RegExpHasFlag (R, cu)を返す。
22.2.6.8 RegExp.prototype [ %Symbol.match% ] ( string )
このメソッドは呼び出された時、以下の手順を実行する:
- rxを
this 値とする。 - rxが
オブジェクトでない場合 、TypeError 例外をthrowする。 - Sを?
ToString (string)とする。 - flagsを?
ToString (?Get (rx,"flags" ))とする。 - flagsが
"g" を含まない場合:- ?
RegExpExec (rx, S)を返す。
- ?
- それ以外の場合:
- flagsが
"u" または"v" を含む場合、fullUnicodeをtrue とし、それ以外はfalse とする。 - ?
Set (rx,"lastIndex" ,+0 𝔽,true )を実行する。 - Aを!
ArrayCreate (0)とする。 - nを0とする。
- 繰り返す:
- resultを?
RegExpExec (rx, S)とする。 - resultが
null の場合:- n = 0 なら
null を返す。 - Aを返す。
- n = 0 なら
- それ以外の場合:
- matchStrを?
ToString (?Get (result,"0" ))とする。 - !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), matchStr)を実行する。 - matchStrが空文字列の場合:
- nをn + 1に設定する。
- matchStrを?
- resultを?
- flagsが
このメソッドの
22.2.6.9 RegExp.prototype [ %Symbol.matchAll% ] ( string )
このメソッドは呼び出された時、以下の手順を実行する:
- Rを
this 値とする。 - Rが
オブジェクトでない場合 、TypeError 例外をthrowする。 - Sを?
ToString (string)とする。 - Cを?
SpeciesConstructor (R,%RegExp% )とする。 - flagsを?
ToString (?Get (R,"flags" ))とする。 - matcherを?
Construct (C, « R, flags »)とする。 - lastIndexを?
ToLength (?Get (R,"lastIndex" ))とする。 - ?
Set (matcher,"lastIndex" , lastIndex,true )を実行する。 - flagsが
"g" を含む場合、globalをtrue とする。 - それ以外の場合、globalを
false とする。 - flagsが
"u" または"v" を含む場合、fullUnicodeをtrue とする。 - それ以外の場合、fullUnicodeを
false とする。 CreateRegExpStringIterator (matcher, S, global, fullUnicode)を返す。
このメソッドの
22.2.6.10 get RegExp.prototype.multiline
RegExp.prototype.multilineは
- Rを
this 値とする。 - cuをコードユニット0x006D（小文字m）とする。
- ?
RegExpHasFlag (R, cu)を返す。
22.2.6.11 RegExp.prototype [ %Symbol.replace% ] ( string, replaceValue )
このメソッドは呼び出された時、以下の手順を実行する:
- rxを
this 値とする。 - rxが
オブジェクトでない場合 、TypeError 例外をthrowする。 - Sを?
ToString (string)とする。 - lengthSをSの長さとする。
- functionalReplaceを
IsCallable (replaceValue)とする。 - functionalReplaceが
false の場合:- replaceValueを?
ToString (replaceValue)に設定する。
- replaceValueを?
- flagsを?
ToString (?Get (rx,"flags" ))とする。 - flagsが
"g" を含む場合、globalをtrue とし、そうでなければfalse とする。 - globalが
true の場合:- ?
Set (rx,"lastIndex" ,+0 𝔽,true )を実行する。
- ?
- resultsを新しい空の
List とする。 - doneを
false とする。 - doneが
false の間、繰り返す:- resultを?
RegExpExec (rx, S)とする。 - resultが
null の場合:- doneを
true に設定する。
- doneを
- それ以外の場合:
- resultをresultsに追加する。
- globalが
false の場合:- doneを
true に設定する。
- doneを
- それ以外の場合:
- resultを?
- accumulatedResultを空文字列とする。
- nextSourcePositionを0とする。
- resultsの各要素resultについて:
- resultLengthを?
LengthOfArrayLike (result)とする。 - nCapturesを
max (resultLength - 1, 0)とする。 - matchedを?
ToString (?Get (result,"0" ))とする。 - matchLengthをmatchedの長さとする。
- positionを?
ToIntegerOrInfinity (?Get (result,"index" ))とする。 - positionを
clamping で0からlengthSの間に収める。 - capturesを新しい空の
List とする。 - nを1とする。
- n ≤ nCapturesの間繰り返す:
- namedCapturesを?
Get (result,"groups" )とする。 - functionalReplaceが
true の場合: - それ以外の場合:
- namedCapturesが
undefined でない場合:- namedCapturesを?
ToObject (namedCaptures)に設定する。
- namedCapturesを?
- replacementStringを?
GetSubstitution (matched, S, position, captures, namedCaptures, replaceValue)とする。
- namedCapturesが
- position ≥ nextSourcePositionの場合:
- resultLengthを?
- nextSourcePosition ≥ lengthSの場合、accumulatedResultを返す。
連結 したaccumulatedResultと部分文字列 （SのnextSourcePosition以降）を返す。
このメソッドの
22.2.6.12 RegExp.prototype [ %Symbol.search% ] ( string )
このメソッドは呼び出された時、以下の手順を実行する:
- rxを
this 値とする。 - rxが
オブジェクトでない場合 、TypeError 例外をthrowする。 - Sを?
ToString (string)とする。 - previousLastIndexを?
Get (rx,"lastIndex" )とする。 - previousLastIndexが
+0 𝔽でない場合:- ?
Set (rx,"lastIndex" ,+0 𝔽,true )を実行する。
- ?
- resultを?
RegExpExec (rx, S)とする。 - currentLastIndexを?
Get (rx,"lastIndex" )とする。 SameValue (currentLastIndex, previousLastIndex)がfalse の場合:- ?
Set (rx,"lastIndex" , previousLastIndex,true )を実行する。
- ?
- resultが
null の場合、-1 𝔽を返す。 - ?
Get (result,"index" )を返す。
このメソッドの
このRegExpオブジェクトの
22.2.6.13 get RegExp.prototype.source
RegExp.prototype.sourceは
- Rを
this 値とする。 - Rが
オブジェクトでない場合 、TypeError 例外をthrowする。 - Rが[[OriginalSource]]内部スロットを持たない場合:
SameValue (R,%RegExp.prototype% ) がtrue なら、"(?:)" を返す。- それ以外の場合、
TypeError 例外をthrowする。
Assert : Rは[[OriginalFlags]]内部スロットを持つ。- srcをR.[[OriginalSource]]とする。
- flagsをR.[[OriginalFlags]]とする。
EscapeRegExpPattern (src, flags)を返す。
22.2.6.13.1 EscapeRegExpPattern ( P, F )
抽象演算EscapeRegExpPatternは引数P（文字列）、F（文字列）を受け取り、文字列を返す。呼び出された時は以下の手順を実行する:
- Fが
"v" を含む場合:- patternSymbolを
Pattern とする。[+UnicodeMode, +UnicodeSetsMode]
- patternSymbolを
- それ以外でFが
"u" を含む場合:- patternSymbolを
Pattern とする。[+UnicodeMode, ~UnicodeSetsMode]
- patternSymbolを
- それ以外の場合:
- patternSymbolを
Pattern とする。[~UnicodeMode, ~UnicodeSetsMode]
- patternSymbolを
- Sを、PをUTF-16エンコードUnicodeコードポイントとして解釈したpatternSymbol形式の文字列で、下記の通り一部コードポイントがエスケープされるものとする。SはPと異なる場合があるが、SをpatternSymbolとして評価した結果の
抽象クロージャ は、生成されたオブジェクトの[[RegExpMatcher]]内部スロットにより与えられる抽象クロージャ と同一の動作をしなければならない。同じ値でこの抽象演算を複数回呼び出した場合、同じ結果を返さなければならない。 - パターン内の
/やLineTerminator となるコードポイントは、連結 した"/" 、S、"/" 、Fが適切な字句的文脈でRegularExpressionLiteral としてパースされ、生成された正規表現と同一の動作になるようにエスケープされなければならない。例えば、Pが"/" の場合、Sは"\/" や"\u002F" などが可能だが、"/" は不可（///の後にFが続くとSingleLineComment としてパースされ、RegularExpressionLiteral にならないため）。Pが空文字列の場合は、Sを"(?:)" とすればよい。 - Sを返す。
名称は似ているが、RegExp.escapeとEscapeRegExpPatternは同様の動作はしない。前者は文字列をパターン内で表現するためにエスケープし、この関数はパターンを文字列として表現するためにエスケープする。
22.2.6.14 RegExp.prototype [ %Symbol.split% ] ( string, limit )
このメソッドは、stringを文字列に変換した結果を分割した部分文字列を格納した配列を返す。部分文字列は左から右へ
/a*?/[Symbol.split]("ab")は["a", "b"]、/a*/[Symbol.split]("ab")は["","b"]になる。）
stringが空文字列（または空文字列に変換される）場合、正規表現が空文字列に一致できるかどうかで結果が変わる。一致できれば結果配列は空、できなければ1要素（空文字列）を含む。
正規表現に括弧によるキャプチャが含まれている場合、区切り一致ごとにキャプチャ結果（
/<(\/)?([^<>]+)>/[Symbol.split]("A<B>bold</B>and<CODE>coded</CODE>")は次の配列になる
["A", undefined, "B", "bold", "/", "B", "and", undefined, "CODE", "coded", "/", "CODE", ""]limitが
このメソッドは呼び出された時、以下の手順を実行する:
- rxを
this 値とする。 - rxが
オブジェクトでない場合 、TypeError 例外をthrowする。 - Sを?
ToString (string)とする。 - Cを?
SpeciesConstructor (rx,%RegExp% )とする。 - flagsを?
ToString (?Get (rx,"flags" ))とする。 - flagsが
"u" または"v" を含む場合、unicodeMatchingをtrue とする。 - それ以外の場合、unicodeMatchingを
false とする。 - flagsが
"y" を含む場合、newFlagsをflagsとする。 - それ以外の場合、newFlagsを
連結 したflagsと"y" とする。 - splitterを?
Construct (C, « rx, newFlags »)とする。 - Aを!
ArrayCreate (0)とする。 - lengthAを0とする。
- limitが
undefined ならlimを232-1、そうでなければlimをℝ (?ToUint32 (limit))とする。 - lim = 0 ならAを返す。
- Sが空文字列の場合:
- zを?
RegExpExec (splitter, S)とする。 - zが
null でなければAを返す。 - !
CreateDataPropertyOrThrow (A,"0" , S)を実行する。 - Aを返す。
- zを?
- sizeをSの長さとする。
- pを0とする。
- qをpとする。
- q < sizeの間繰り返す:
- ?
Set (splitter,"lastIndex" ,𝔽 (q),true )を実行する。 - zを?
RegExpExec (splitter, S)とする。 - zが
null の場合:- qを
AdvanceStringIndex (S, q, unicodeMatching)に設定する。
- qを
- それ以外の場合:
- eを
ℝ (?ToLength (?Get (splitter,"lastIndex" )))とする。 - eを
min (e, size)に設定する。 - e = pの場合:
- qを
AdvanceStringIndex (S, q, unicodeMatching)に設定する。
- qを
- それ以外の場合:
- Tを
部分文字列 （Sのpからqまで）とする。 - !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (lengthA)), T)を実行する。 - lengthAをlengthA + 1に設定する。
- lengthA = limならAを返す。
- pをeに設定する。
- numberOfCapturesを?
LengthOfArrayLike (z)とする。 - numberOfCapturesを
max (numberOfCaptures - 1, 0)に設定する。 - iを1とする。
- i ≤ numberOfCapturesの間繰り返す:
- qをpに設定する。
- Tを
- eを
- ?
- Tを
部分文字列 （Sのpからsizeまで）とする。 - !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (lengthA)), T)を実行する。 - Aを返す。
このメソッドの
このメソッドはこのRegExpオブジェクトの
22.2.6.15 get RegExp.prototype.sticky
RegExp.prototype.stickyは
- Rを
this 値とする。 - cuをコードユニット0x0079（小文字y）とする。
- ?
RegExpHasFlag (R, cu)を返す。
22.2.6.16 RegExp.prototype.test ( S )
このメソッドは呼び出された時、以下の手順を実行する:
- Rを
this 値とする。 - Rが
オブジェクトでない場合 、TypeError 例外をthrowする。 - stringを?
ToString (S)とする。 - matchを?
RegExpExec (R, string)とする。 - matchが
null でなければtrue を返し、そうでなければfalse を返す。
22.2.6.17 RegExp.prototype.toString ( )
返される文字列は
22.2.6.18 get RegExp.prototype.unicode
RegExp.prototype.unicodeは
- Rを
this 値とする。 - cuをコードユニット0x0075（小文字u）とする。
- ?
RegExpHasFlag (R, cu)を返す。
22.2.6.19 get RegExp.prototype.unicodeSets
RegExp.prototype.unicodeSetsは
- Rを
this 値とする。 - cuをコードユニット0x0076（小文字v）とする。
- ?
RegExpHasFlag (R, cu)を返す。
22.2.7 正規表現マッチング用抽象演算
22.2.7.1 RegExpExec ( R, S )
抽象演算RegExpExecは、引数R（オブジェクト）とS（文字列）を受け取り、
- execを?
Get (R,"exec" )とする。 IsCallable (exec)がtrue の場合:- ?
RequireInternalSlot (R, [[RegExpMatcher]])を実行する。 - ?
RegExpBuiltinExec (R, S)を返す。
呼び出可能な
22.2.7.2 RegExpBuiltinExec ( R, S )
抽象演算RegExpBuiltinExecは、引数R（初期化済みRegExpインスタンス）、S（文字列）を受け取り、
- lengthをSの長さとする。
- lastIndexを
ℝ (?ToLength (?Get (R,"lastIndex" )))とする。 - flagsをR.[[OriginalFlags]]とする。
- flagsが
"g" を含む場合globalをtrue 、それ以外はfalse とする。 - flagsが
"y" を含む場合stickyをtrue 、それ以外はfalse とする。 - flagsが
"d" を含む場合hasIndicesをtrue 、それ以外はfalse とする。 - globalが
false かつstickyがfalse の場合、lastIndexを0に設定する。 - matcherをR.[[RegExpMatcher]]とする。
- flagsが
"u" または"v" を含む場合fullUnicodeをtrue 、それ以外はfalse とする。 - matchSucceededを
false とする。 - fullUnicodeが
true の場合inputをStringToCodePoints (S)、それ以外はinputをList （Sのコードユニット列）とする。 - 注: inputの各要素は文字とみなす。
- matchSucceededが
false の間繰り返す:- lastIndex > lengthの場合:
- globalが
true またはstickyがtrue の場合:- ?
Set (R,"lastIndex" ,+0 𝔽,true )を実行する。
- ?
null を返す。
- globalが
- inputIndexをSのlastIndex番目の要素から取得されるinputのインデックスとする。
- rをmatcher(input, inputIndex)とする。
- rが
failure の場合:- stickyが
true の場合:- ?
Set (R,"lastIndex" ,+0 𝔽,true )を実行する。 null を返す。
- ?
- lastIndexを
AdvanceStringIndex (S, lastIndex, fullUnicode)に設定する。
- stickyが
- それ以外の場合:
Assert : rはMatchState である。- matchSucceededを
true に設定する。
- lastIndex > lengthの場合:
- eをr.[[EndIndex]]とする。
- fullUnicodeが
true の場合、eをGetStringIndex (S, e)に設定する。 - globalが
true またはstickyがtrue の場合: - nをr.[[Captures]]の要素数とする。
Assert : n = R.[[RegExpRecord]].[[CapturingGroupsCount]]である。Assert : n < 232 - 1。- Aを!
ArrayCreate (n + 1)とする。 Assert : Aの"length" プロパティの数学的値はn + 1である。- !
CreateDataPropertyOrThrow (A,"index" ,𝔽 (lastIndex))を実行する。 - !
CreateDataPropertyOrThrow (A,"input" , S)を実行する。 - matchを
Match Record { [[StartIndex]]: lastIndex, [[EndIndex]]: e }とする。 - indicesを新しい空の
List とする。 - groupNamesを新しい空の
List とする。 - matchをindicesに追加する。
- matchedSubstrを
GetMatchString (S, match)とする。 - !
CreateDataPropertyOrThrow (A,"0" , matchedSubstr)を実行する。 - Rが
GroupName を含む場合:- groupsを
OrdinaryObjectCreate (null )とする。 - hasGroupsを
true とする。
- groupsを
- それ以外の場合:
- groupsを
undefined とする。 - hasGroupsを
false とする。
- groupsを
- !
CreateDataPropertyOrThrow (A,"groups" , groups)を実行する。 - matchedGroupNamesを新しい空の
List とする。 - 1 ≤ i ≤ nの各
整数 iについて昇順で、以下を行う:- captureIをr.[[Captures]]のi番目の要素とする。
- captureIが
undefined の場合:- capturedValueを
undefined とする。 undefined をindicesに追加する。
- capturedValueを
- それ以外の場合:
- captureStartをcaptureI.[[StartIndex]]とする。
- captureEndをcaptureI.[[EndIndex]]とする。
- fullUnicodeが
true の場合:- captureStartを
GetStringIndex (S, captureStart)に設定する。 - captureEndを
GetStringIndex (S, captureEnd)に設定する。
- captureStartを
- captureを
Match Record { [[StartIndex]]: captureStart, [[EndIndex]]: captureEnd }とする。 - capturedValueを
GetMatchString (S, capture)とする。 - captureをindicesに追加する。
- !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (i)), capturedValue)を実行する。 - Rのi番目のキャプチャが
GroupName で定義されている場合:- sをその
GroupName のCapturingGroupName とする。 - matchedGroupNamesがsを含む場合:
Assert : capturedValueはundefined である。undefined をgroupNamesに追加する。
- それ以外の場合:
- capturedValueが
undefined でなければsをmatchedGroupNamesに追加する。 - 注:
同じ名前のグループが複数ある場合、groupsはこの時点ですでにsプロパティを持つ可能性がある。ただし、groupsはすべてのプロパティが書き込み可能な
通常のオブジェクト であり、データプロパティ なので、CreateDataPropertyOrThrow の呼び出しは必ず成功する。 - !
CreateDataPropertyOrThrow (groups, s, capturedValue)を実行する。 - sをgroupNamesに追加する。
- capturedValueが
- sをその
- それ以外の場合:
undefined をgroupNamesに追加する。
- hasIndicesが
true の場合:- indicesArrayを
MakeMatchIndicesIndexPairArray (S, indices, groupNames, hasGroups)とする。 - !
CreateDataPropertyOrThrow (A,"indices" , indicesArray)を実行する。
- indicesArrayを
- Aを返す。
22.2.7.3 AdvanceStringIndex ( S, index, unicode )
抽象演算AdvanceStringIndexは、引数S（文字列）、index（非負
Assert : index ≤ 253 - 1。- unicodeが
false の場合、index + 1を返す。 - lengthをSの長さとする。
- index + 1 ≥ lengthの場合、index + 1を返す。
- cpを
CodePointAt (S, index)とする。 - index + cp.[[CodeUnitCount]]を返す。
22.2.7.4 GetStringIndex ( S, codePointIndex )
抽象演算GetStringIndexは、引数S（文字列）、codePointIndex（非負
- Sが空文字列の場合、0を返す。
- lenをSの長さとする。
- codeUnitCountを0とする。
- codePointCountを0とする。
- codeUnitCount < lenの間繰り返す:
- codePointCount = codePointIndexならcodeUnitCountを返す。
- cpを
CodePointAt (S, codeUnitCount)とする。 - codeUnitCountをcodeUnitCount + cp.[[CodeUnitCount]]に設定する。
- codePointCountをcodePointCount + 1に設定する。
- lenを返す。
22.2.7.5 マッチレコード
マッチレコードは、正規表現一致・キャプチャの開始・終了インデックスをカプセル化するために使用される
マッチレコードは
22.2.7.6 GetMatchString ( S, match )
抽象演算GetMatchStringは、引数S（文字列）、match（
22.2.7.7 GetMatchIndexPair ( S, match )
抽象演算GetMatchIndexPairは、引数S（文字列）、match（
Assert : match.[[StartIndex]] ≤ match.[[EndIndex]] ≤ Sの長さ。CreateArrayFromList («𝔽 (match.[[StartIndex]]),𝔽 (match.[[EndIndex]]) »)を返す。
22.2.7.8 MakeMatchIndicesIndexPairArray ( S, indices, groupNames, hasGroups )
抽象演算MakeMatchIndicesIndexPairArrayは、引数S（文字列）、indices（
- nをindicesの要素数とする。
Assert : n < 232 - 1。Assert : groupNamesはn - 1個の要素を持つ。- 注: groupNamesの
List はindicesのList のindices[1]から揃っている。 - Aを!
ArrayCreate (n)とする。 - hasGroupsが
true の場合:- groupsを
OrdinaryObjectCreate (null )とする。
- groupsを
- それ以外の場合:
- groupsを
undefined とする。
- groupsを
- !
CreateDataPropertyOrThrow (A,"groups" , groups)を実行する。 - 0 ≤ i < nの各
整数 iについて昇順で、以下を行う:- matchIndicesをindices[i]とする。
- matchIndicesが
undefined でない場合:- matchIndexPairを
GetMatchIndexPair (S, matchIndices)とする。
- matchIndexPairを
- それ以外の場合:
- matchIndexPairを
undefined とする。
- matchIndexPairを
- !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (i)), matchIndexPair)を実行する。 - i > 0の場合:
- sをgroupNames[i - 1]とする。
- sが
undefined でない場合:Assert : groupsはundefined でない。- 注:
同じ名前のグループが複数ある場合、groupsはこの時点ですでにsプロパティを持つ可能性がある。ただし、groupsはすべてのプロパティが書き込み可能な
通常のオブジェクト であり、データプロパティ なので、CreateDataPropertyOrThrow の呼び出しは必ず成功する。 - !
CreateDataPropertyOrThrow (groups, s, matchIndexPair)を実行する。
- Aを返す。
22.2.8 RegExpインスタンスのプロパティ
RegExpインスタンスは
RegExpインスタンスはさらに以下のプロパティを持つ:
22.2.8.1 lastIndex
22.2.9 RegExp文字列イテレータオブジェクト
RegExp文字列イテレータは、ある特定のStringインスタンスオブジェクトに対する、特定のRegExpインスタンスオブジェクトによるイテレーションを表すオブジェクトである。RegExp文字列イテレータオブジェクトには名前付き
22.2.9.1 CreateRegExpStringIterator ( R, S, global, fullUnicode )
抽象演算CreateRegExpStringIteratorは、引数R（オブジェクト）、S（文字列）、global（Boolean）、fullUnicode（Boolean）を受け取り、オブジェクトを返す。呼び出された時は以下の手順を実行する:
- iteratorを
OrdinaryObjectCreate (%RegExpStringIteratorPrototype% , « [[IteratingRegExp]], [[IteratedString]], [[Global]], [[Unicode]], [[Done]] »)とする。 - iterator.[[IteratingRegExp]]にRを設定する。
- iterator.[[IteratedString]]にSを設定する。
- iterator.[[Global]]にglobalを設定する。
- iterator.[[Unicode]]にfullUnicodeを設定する。
- iterator.[[Done]]に
false を設定する。 - iteratorを返す。
22.2.9.2 %RegExpStringIteratorPrototype% オブジェクト
%RegExpStringIteratorPrototype%オブジェクト:
- すべての
RegExp文字列イテレータオブジェクト が継承するプロパティを持つ。 通常のオブジェクト である。- [[Prototype]]内部スロットを持ち、その値は
%Iterator.prototype% である。 - 以下のプロパティを持つ。
22.2.9.2.1 %RegExpStringIteratorPrototype%.next ( )
- Oを
this 値とする。 - Oが
オブジェクトでない場合 、TypeError 例外をthrowする。 - Oが
RegExp文字列イテレータ オブジェクトインスタンスのすべての内部スロットを持たない場合（22.2.9.3 参照）、TypeError 例外をthrowする。 - O.[[Done]]が
true の場合:CreateIteratorResultObject (undefined ,true )を返す。
- RをO.[[IteratingRegExp]]とする。
- SをO.[[IteratedString]]とする。
- globalをO.[[Global]]とする。
- fullUnicodeをO.[[Unicode]]とする。
- matchを?
RegExpExec (R, S)とする。 - matchが
null の場合:- O.[[Done]]に
true を設定する。 CreateIteratorResultObject (undefined ,true )を返す。
- O.[[Done]]に
- globalが
false の場合:- O.[[Done]]に
true を設定する。 CreateIteratorResultObject (match,false )を返す。
- O.[[Done]]に
- matchStrを?
ToString (?Get (match,"0" ))とする。 - matchStrが空文字列の場合:
CreateIteratorResultObject (match,false )を返す。
22.2.9.2.2 %RegExpStringIteratorPrototype% [ %Symbol.toStringTag% ]
このプロパティは属性{ [[Writable]]:
22.2.9.3 RegExp文字列イテレータインスタンスのプロパティ
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[IteratingRegExp]] | オブジェクト | イテレーションに用いる正規表現。 |
| [[IteratedString]] | 文字列 | イテレート対象の文字列値。 |
| [[Global]] | Boolean | [[IteratingRegExp]]がグローバルかどうかを示す。 |
| [[Unicode]] | Boolean | [[IteratingRegExp]]がUnicodeモードかどうかを示す。 |
| [[Done]] | Boolean | イテレーションが完了しているかどうかを示す。 |
23 インデックス付きコレクション
23.1 配列オブジェクト
配列は、特定のプロパティ名のクラスに特別な扱いをする
23.1.1 Array コンストラクター
Array
- %Array%です。
"Array" プロパティの初期値としてグローバルオブジェクト に設定されています。コンストラクター として呼び出されたとき、新しい配列を作成し初期化します。コンストラクター としてではなく、関数として呼び出された場合も新しい配列を作成し初期化します。したがって、関数呼び出しArray(…)は、同じ引数を使ったオブジェクト生成式new Array(…)と同等です。- 引数の数や型によって動作が異なる関数です。
- クラス定義の
extends節の値として使用することができます。エキゾチックな配列の動作を継承したいサブクラスのコンストラクター は、Array コンストラクター へのsuper呼び出しを含める必要があり、Array エキゾチックオブジェクト であるサブクラスインスタンスを初期化します。ただし、ほとんどのArray.prototypeメソッドはジェネリックメソッドであり、そのthis 値がArray エキゾチックオブジェクト であることに依存しません。
23.1.1.1 Array ( ...values )
この関数は呼び出されたとき、以下の手順を実行します：
- NewTarget が
undefined の場合、newTarget にアクティブ関数オブジェクト を設定する。そうでなければ newTarget に NewTarget を設定する。 - proto を ?
GetPrototypeFromConstructor (newTarget,"%Array.prototype%" ) とする。 - numberOfArgs を values の要素数とする。
- numberOfArgs = 0 の場合、
- !
ArrayCreate (0, proto) を返す。
- !
- そうでなく numberOfArgs = 1 の場合、
- len を values[0] とする。
- array を !
ArrayCreate (0, proto) とする。 - len が
Number でない 場合、- !
CreateDataPropertyOrThrow (array,"0" , len) を実行する。 - intLen を
1 𝔽 とする。
- !
- それ以外の場合、
- intLen を !
ToUint32 (len) とする。 SameValueZero (intLen, len) がfalse の場合、RangeError 例外を投げる。
- intLen を !
- !
Set (array,"length" , intLen,true ) を実行する。 - array を返す。
- それ以外の場合、
アサート : numberOfArgs ≥ 2。- array を ?
ArrayCreate (numberOfArgs, proto) とする。 - k を 0 とする。
- k < numberOfArgs の間、繰り返す：
- Pk を !
ToString (𝔽 (k)) とする。 - itemK を values[k] とする。
- !
CreateDataPropertyOrThrow (array, Pk, itemK) を実行する。 - k を k + 1 に設定する。
- Pk を !
アサート :数学的値 array の"length" プロパティは numberOfArgs である。- array を返す。
23.1.2 Array コンストラクターのプロパティ
Array
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 "length" プロパティを持ち、その値は1 𝔽 です。- 以下のプロパティを持ちます:
23.1.2.1 Array.from ( items [ , mapper [ , thisArg ] ] )
このメソッドは呼び出されたとき、次の手順を実行します:
- C を
this の値とする。 - mapper が
undefined なら、- mapping を
false とする。
- mapping を
- それ以外の場合、
IsCallable (mapper) がfalse なら、TypeError 例外を投げる。- mapping を
true とする。
- usingIterator を ?
GetMethod (items,%Symbol.iterator% ) とする。 - usingIterator が
undefined でない場合、IsConstructor (C) がtrue なら、- A を ?
Construct (C) とする。
- A を ?
- それ以外の場合、
- A を !
ArrayCreate (0) とする。
- A を !
- iteratorRecord を ?
GetIteratorFromMethod (items, usingIterator) とする。 - k を 0 とする。
- 繰り返す、
- k ≥ 253 - 1 なら、
- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iteratorRecord, error) を返す。
- error を
- Pk を !
ToString (𝔽 (k)) とする。 - next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done なら、 - mapping が
true なら、- mappedValue を
Completion (Call (mapper, thisArg, « next,𝔽 (k) »)) とする。 IfAbruptCloseIterator (mappedValue, iteratorRecord) を実行する。
- mappedValue を
- それ以外の場合、
- mappedValue を next とする。
- defineStatus を
Completion (CreateDataPropertyOrThrow (A, Pk, mappedValue)) とする。 IfAbruptCloseIterator (defineStatus, iteratorRecord) を実行する。- k を k + 1 に設定する。
- k ≥ 253 - 1 なら、
- 注: items は
iterable ではないため、配列ライクオブジェクト であるとみなします。 - arrayLike を !
ToObject (items) とする。 - len を ?
LengthOfArrayLike (arrayLike) とする。 IsConstructor (C) がtrue なら、- それ以外の場合、
- A を ?
ArrayCreate (len) とする。
- A を ?
- k を 0 とする。
- k < len の間、繰り返す:
- ?
Set (A,"length" ,𝔽 (len),true ) を実行する。 - A を返す。
23.1.2.2 Array.isArray ( arg )
この関数は呼び出されたとき、以下の手順を実行します:
- ?
IsArray (arg) を返す。
23.1.2.3 Array.of ( ...items )
このメソッドは呼び出されたとき、以下の手順を実行します:
- len を items の要素数とする。
- lenNumber を
𝔽 (len) とする。 - C を
this の値とする。 IsConstructor (C) がtrue なら、- A を ?
Construct (C, « lenNumber ») とする。
- A を ?
- それ以外の場合、
- A を ?
ArrayCreate (len) とする。
- A を ?
- k を 0 とする。
- k < len の間、繰り返す:
- kValue を items[k] とする。
- Pk を !
ToString (𝔽 (k)) とする。 - ?
CreateDataPropertyOrThrow (A, Pk, kValue) を実行する。 - k を k + 1 に設定する。
- ?
Set (A,"length" , lenNumber,true ) を実行する。 - A を返す。
23.1.2.4 Array.prototype
Array.prototype の値は
このプロパティの属性は { [[Writable]]:
23.1.2.5 get Array [ %Symbol.species% ]
Array[%Symbol.species%] は
this の値を返す。
この関数の
Array プロトタイプメソッドは通常、
23.1.3 Array プロトタイプオブジェクトのプロパティ
Array プロトタイプオブジェクトは:
- %Array.prototype%です。
Array エキゾチックオブジェクト であり、そのようなオブジェクトに指定された内部メソッドを持ちます。"length" プロパティを持ち、初期値は+0 𝔽であり、属性は { [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false } です。- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% です。
Array プロトタイプオブジェクトは
23.1.3.1 Array.prototype.at ( index )
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - relativeIndex を ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0 の場合、
- k を relativeIndex とする。
- それ以外の場合、
- k を len + relativeIndex とする。
- k < 0 または k ≥ len
の場合、
undefined を返す。 - ?
Get (O, !ToString (𝔽 (k))) を返す。
23.1.3.2 Array.prototype.concat ( ...items )
このメソッドは、オブジェクトの配列要素の後に各引数の配列要素を続けて含む配列を返します。
呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - A を ?
ArraySpeciesCreate (O, 0) とする。 - n を 0 とする。
- O を items の先頭に追加する。
- items の各要素 E について、
- spreadable を ?
IsConcatSpreadable (E) とする。 - spreadable が
true の場合、- len を ?
LengthOfArrayLike (E) とする。 - n + len > 253 - 1
の場合、
TypeError 例外を投げる。 - k を 0 とする。
- k < len の間、繰り返す:
- Pk を !
ToString (𝔽 (k)) とする。 - exists を ?
HasProperty (E, Pk) とする。 - exists が
true の場合、- subElement を ?
Get (E, Pk) とする。 - ?
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), subElement) を実行する。
- subElement を ?
- n を n + 1 に設定する。
- k を k + 1 に設定する。
- Pk を !
- len を ?
- それ以外の場合、
- 注: E は spread されずに単一の要素として追加されます。
- n ≥ 253 - 1 の場合、
TypeError 例外を投げる。 - ?
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), E) を実行する。 - n を n + 1 に設定する。
- spreadable を ?
- ?
Set (A,"length" ,𝔽 (n),true ) を実行する。 - A を返す。
このメソッドの
手順
このメソッドは意図的にジェネリックです。
23.1.3.2.1 IsConcatSpreadable ( O )
抽象操作 IsConcatSpreadable は引数 O (
- Oが
オブジェクトでない 場合、false を返す。 - spreadable を ?
Get (O,%Symbol.isConcatSpreadable% ) とする。 - spreadable が
undefined でない場合、ToBoolean (spreadable) を返す。 - ?
IsArray (O) を返す。
23.1.3.3 Array.prototype.constructor
Array.prototype.constructor の初期値は
23.1.3.4 Array.prototype.copyWithin ( target, start [ , end ] )
end 引数は省略可能です。指定されない場合、
target が負の場合、配列の長さを length として
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - relativeTarget を ?
ToIntegerOrInfinity (target) とする。 - relativeTarget = -∞ の場合、to を 0 とする。
- それ以外で relativeTarget < 0 の場合、to を
max (len + relativeTarget, 0) とする。 - それ以外の場合、to を
min (relativeTarget, len) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、from を 0 とする。
- それ以外で relativeStart < 0 の場合、from を
max (len + relativeStart, 0) とする。 - それ以外の場合、from を
min (relativeStart, len) とする。 - end が
undefined の場合、relativeEnd を len とし、それ以外は relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、final を 0 とする。
- それ以外で relativeEnd < 0 の場合、final を
max (len + relativeEnd, 0) とする。 - それ以外の場合、final を
min (relativeEnd, len) とする。 - count を
min (final - from, len - to) とする。 - from < to かつ to < from +
count の場合、
- direction を -1 とする。
- from を from + count - 1 に設定する。
- to を to + count - 1 に設定する。
- それ以外の場合、
- direction を 1 とする。
- count > 0 の間、繰り返す:
- fromKey を !
ToString (𝔽 (from)) とする。 - toKey を !
ToString (𝔽 (to)) とする。 - fromPresent を ?
HasProperty (O, fromKey) とする。 - fromPresent が
true の場合、 - それ以外の場合、
アサート : fromPresent はfalse です。- ?
DeletePropertyOrThrow (O, toKey) を実行する。
- from を from + direction に設定する。
- to を to + direction に設定する。
- count を count - 1 に設定する。
- fromKey を !
- O を返す。
このメソッドは意図的にジェネリックです。
23.1.3.5 Array.prototype.entries ( )
このメソッドは、呼び出されたとき以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 CreateArrayIterator (O,key+value ) を返す。
23.1.3.6 Array.prototype.every ( callback [ , thisArg ] )
callbackは3つの引数を受け取り、Boolean値に変換可能な値を返す関数である必要があります。everyは配列内の各要素に対して昇順でcallbackを1回ずつ呼び出し、callbackがeveryは直ちにeveryは
thisArgパラメータが指定された場合、各callback呼び出しの
callbackは、要素の値、要素のインデックス、走査対象のオブジェクトの3つの引数で呼び出されます。
everyは呼び出し元のオブジェクトを直接変更しませんが、callbackの呼び出しによってオブジェクトが変更される可能性があります。
everyが処理する要素の範囲は、最初のcallback呼び出し前に決まります。everyの呼び出し開始後に配列に追加された要素はcallbackによって訪問されません。既存の配列要素が変更された場合、その値はeveryが訪問した時点の値になります。呼び出し開始後かつ訪問前に削除された要素は訪問されません。everyは数学における「すべて」の量化子のように振る舞います。特に、空配列の場合は
このメソッドは、呼び出されたとき以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- k を 0 とする。
- k < len の間、繰り返す:
true を返す。
このメソッドは意図的にジェネリックです。
23.1.3.7 Array.prototype.fill ( value [ , start [ , end ] ] )
start 引数は省略可能です。指定されない場合は
end 引数は省略可能です。指定されない場合、
startが負の場合、配列の長さをlengthとして
このメソッドは、呼び出されたとき以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、k を 0 とする。
- それ以外で relativeStart < 0 の場合、k を
max (len + relativeStart, 0) とする。 - それ以外の場合、k を
min (relativeStart, len) とする。 - end が
undefined の場合、relativeEnd をlenとし、それ以外はrelativeEndを?ToIntegerOrInfinity (end)とする。 - relativeEnd = -∞ の場合、final を0とする。
- それ以外で relativeEnd < 0 の場合、final を
max (len + relativeEnd, 0) とする。 - それ以外の場合、final を
min (relativeEnd, len) とする。 - k < final の間、繰り返す:
- O を返す。
このメソッドは意図的にジェネリックです。
23.1.3.8 Array.prototype.filter ( callback [ , thisArg ] )
callbackは3つの引数を受け取り、Boolean値に変換可能な値を返す関数である必要があります。filterは配列内の各要素に対して昇順でcallbackを1回ずつ呼び出し、callbackが
thisArgパラメータが指定された場合、各callback呼び出しの
callbackは、要素の値、要素のインデックス、走査対象のオブジェクトの3つの引数で呼び出されます。
filterは呼び出し元のオブジェクトを直接変更しませんが、callbackの呼び出しによってオブジェクトが変更される可能性があります。
filterが処理する要素の範囲は、最初のcallback呼び出し前に決まります。filterの呼び出し開始後に配列に追加された要素はcallbackによって訪問されません。既存の配列要素が変更された場合、その値はfilterが訪問した時点の値になります。呼び出し開始後かつ訪問前に削除された要素は訪問されません。
このメソッドは、呼び出されたとき以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- A を ?
ArraySpeciesCreate (O, 0) とする。 - k を 0 とする。
- to を 0 とする。
- k < len の間、繰り返す:
- Pk を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (O, Pk) とする。 - kPresent が
true の場合、 - k を k + 1 に設定する。
- Pk を !
- A を返す。
このメソッドは意図的にジェネリックです。
23.1.3.9 Array.prototype.find ( predicate [ , thisArg ] )
このメソッドは、配列の各要素に対して昇順インデックスでpredicateを1回ずつ呼び出し、predicateがfindは直ちにその要素値を返します。そうでなければfindは
詳細は
このメソッドは、呼び出されたとき以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - findRec を ?
FindViaPredicate (O, len,ascending , predicate, thisArg) とする。 - findRec.[[Value]] を返す。
このメソッドは意図的にジェネリックです。
23.1.3.10 Array.prototype.findIndex ( predicate [ , thisArg ] )
このメソッドは、配列の各要素に対して昇順インデックスでpredicateを1回ずつ呼び出し、predicateがfindIndexは直ちにその要素値のインデックスを返します。そうでなければfindIndexは-1を返します。
詳細は
このメソッドは、呼び出されたとき以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - findRec を ?
FindViaPredicate (O, len,ascending , predicate, thisArg) とする。 - findRec.[[Index]] を返す。
このメソッドは意図的にジェネリックです。
23.1.3.11 Array.prototype.findLast ( predicate [ , thisArg ] )
このメソッドは、配列の各要素に対して降順インデックスでpredicateを1回ずつ呼び出し、predicateがfindLastは直ちにその要素値を返します。そうでなければfindLastは
詳細は
このメソッドは、呼び出されたとき以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - findRec を ?
FindViaPredicate (O, len,descending , predicate, thisArg) とする。 - findRec.[[Value]] を返す。
このメソッドは意図的にジェネリックです。
23.1.3.12 Array.prototype.findLastIndex ( predicate [ , thisArg ] )
このメソッドは、配列の各要素に対して降順インデックスでpredicateを1回ずつ呼び出し、predicateがfindLastIndexは直ちにその要素値のインデックスを返します。そうでなければfindLastIndexは-1を返します。
詳細は
このメソッドは、呼び出されたとき以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - findRec を ?
FindViaPredicate (O, len,descending , predicate, thisArg) とする。 - findRec.[[Index]] を返す。
このメソッドは意図的にジェネリックです。
23.1.3.12.1 FindViaPredicate ( O, len, direction, predicate, thisArg )
抽象操作 FindViaPredicate は、引数 O (オブジェクト)、len (非負の
Oは
predicateは関数であるべきです。配列の各要素の呼び出し時には、要素の値、要素のインデックス、走査対象のオブジェクトの3つの引数が渡されます。その戻り値はBoolean値に変換されます。
thisArgは各predicate呼び出し時の
この操作は呼び出し元オブジェクトを直接変更しませんが、predicateの呼び出しによってオブジェクトが変更される可能性があります。
処理する要素の範囲は、predicateの最初の呼び出し直前（走査開始前）に決まります。走査開始後に配列へ追加された要素はpredicateによって訪問されません。既存の配列要素が変更された場合、その値はこの操作が訪問した時点の値になります。走査開始後かつ訪問前に削除された要素も訪問され、プロトタイプから取得されるか
この操作は、呼び出されたとき以下の手順を実行します:
IsCallable (predicate) がfalse なら、TypeError 例外を投げる。- directionが
ascending なら、 - それ以外の場合、
- indicesの各
整数 kについて、 Record { [[Index]]:-1 𝔽, [[Value]]:undefined }を返す。
23.1.3.13 Array.prototype.flat ( [ depth ] )
このメソッドは、呼び出されたとき以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - sourceLen を ?
LengthOfArrayLike (O) とする。 - depthNum を 1 とする。
- depth が
undefined でない場合、- depthNum を ?
ToIntegerOrInfinity (depth)に設定する。 - depthNum < 0 の場合、depthNum を 0 に設定する。
- depthNum を ?
- A を ?
ArraySpeciesCreate (O, 0) とする。 - ?
FlattenIntoArray (A, O, sourceLen, 0, depthNum) を実行する。 - A を返す。
23.1.3.13.1 FlattenIntoArray ( target, source, sourceLen, start, depth [ , mapperFunction [ , thisArg ] ] )
抽象操作 FlattenIntoArray は、引数
target（オブジェクト）、source（オブジェクト）、sourceLen（非負の
アサート : mapperFunctionが存在する場合、IsCallable (mapperFunction) がtrue であり、thisArgが存在し、depthは1である。- targetIndex を startとする。
- sourceIndex を
+0 𝔽とする。 ℝ (sourceIndex) < sourceLen の間、繰り返す:- P を !
ToString (sourceIndex)とする。 - exists を ?
HasProperty (source, P)とする。 - exists が
true の場合、- element を ?
Get (source, P)とする。 - mapperFunctionが存在する場合、
- element を ?
Call (mapperFunction, thisArg, « element, sourceIndex, source »)に設定する。
- element を ?
- shouldFlatten を
false とする。 - depth > 0 の場合、
- shouldFlatten を ?
IsArray (element)に設定する。
- shouldFlatten を ?
- shouldFlatten が
true の場合、- depth = +∞ の場合、newDepth を +∞とする。
- それ以外は、newDepth を depth - 1とする。
- elementLen を ?
LengthOfArrayLike (element)とする。 - targetIndex を ?
FlattenIntoArray (target, element, elementLen, targetIndex, newDepth)に設定する。
- それ以外の場合、
- targetIndex ≥ 253 - 1
の場合、
TypeError 例外を投げる。 - ?
CreateDataPropertyOrThrow (target, !ToString (𝔽 (targetIndex)), element) を実行する。 - targetIndex を targetIndex + 1に設定する。
- targetIndex ≥ 253 - 1
の場合、
- element を ?
- sourceIndex を sourceIndex +
1 𝔽に設定する。
- P を !
- targetIndex を返す。
23.1.3.14 Array.prototype.flatMap ( mapperFunction [ , thisArg ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - sourceLen を ?
LengthOfArrayLike (O) とする。 IsCallable (mapperFunction) がfalse なら、TypeError 例外を投げる。- A を ?
ArraySpeciesCreate (O, 0) とする。 - ?
FlattenIntoArray (A, O, sourceLen, 0, 1, mapperFunction, thisArg) を実行する。 - A を返す。
23.1.3.15 Array.prototype.forEach ( callback [ , thisArg ] )
callbackは3つの引数を受け取る関数である必要があります。forEachは配列内の各要素に対して昇順でcallbackを1回ずつ呼び出します。callbackは実際に存在する配列の要素に対してのみ呼び出され、欠損要素には呼び出されません。
thisArgパラメータが指定された場合、各callback呼び出しの
callbackは、要素の値、要素のインデックス、走査対象のオブジェクトの3つの引数で呼び出されます。
forEachは呼び出し元のオブジェクトを直接変更しませんが、callbackの呼び出しによってオブジェクトが変更される可能性があります。
forEachが処理する要素の範囲は、最初のcallback呼び出し前に決まります。forEachの呼び出し開始後に配列に追加された要素はcallbackによって訪問されません。既存の配列要素が変更された場合、その値はforEachが訪問した時点の値になります。呼び出し開始後かつ訪問前に削除された要素は訪問されません。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- k を 0 とする。
- k < len の間、繰り返す:
undefined を返す。
このメソッドは意図的にジェネリックです。
23.1.3.16 Array.prototype.includes ( searchElement [ , fromIndex ] )
このメソッドはsearchElementを配列の各要素と昇順で比較し、
オプションの第2引数fromIndexはデフォルトで
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - len = 0 の場合、
false を返す。 - n を ?
ToIntegerOrInfinity (fromIndex) とする。 アサート : fromIndexがundefined なら、nは0。- n = +∞ の場合、
false を返す。 - それ以外で n = -∞ の場合、n を 0 に設定する。
- n ≥ 0 の場合、
- k を n とする。
- それ以外の場合、
- k を len + n とする。
- k < 0 の場合、k を 0 に設定する。
- k < len の間、繰り返す:
- elementK を ?
Get (O, !ToString (𝔽 (k))) とする。 SameValueZero (searchElement, elementK) がtrue の場合、true を返す。- k を k + 1 に設定する。
- elementK を ?
false を返す。
このメソッドは意図的にジェネリックです。
このメソッドは類似のindexOfメソッドと意図的に2つの点で異なります。1つ目は
23.1.3.17 Array.prototype.indexOf ( searchElement [ , fromIndex ] )
このメソッドはsearchElementを配列の各要素と昇順で比較し、
オプションの第2引数fromIndexはデフォルトで
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - len = 0 の場合、
-1 𝔽 を返す。 - n を ?
ToIntegerOrInfinity (fromIndex) とする。 アサート : fromIndexがundefined なら、nは0。- n = +∞ の場合、
-1 𝔽 を返す。 - それ以外で n = -∞ の場合、n を 0 に設定する。
- n ≥ 0 の場合、
- k を n とする。
- それ以外の場合、
- k を len + n とする。
- k < 0 の場合、k を 0 に設定する。
- k < len の間、繰り返す:
- Pk を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (O, Pk) とする。 - kPresent が
true の場合、- elementK を ?
Get (O, Pk) とする。 IsStrictlyEqual (searchElement, elementK) がtrue の場合、𝔽 (k) を返す。
- elementK を ?
- k を k + 1 に設定する。
- Pk を !
-1 𝔽 を返す。
このメソッドは意図的にジェネリックです。
23.1.3.18 Array.prototype.join ( separator )
このメソッドは配列の要素を文字列に変換し、それらの文字列をseparatorの出現で区切って連結します。区切り文字が指定されない場合、区切り文字としてカンマ1個が使用されます。
呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - separator が
undefined の場合、sep を"," とする。 - それ以外の場合、sep を ?
ToString (separator) とする。 - R を空文字列とする。
- k を 0 とする。
- k < len の間、繰り返す:
- R を返す。
このメソッドは意図的にジェネリックです。
23.1.3.19 Array.prototype.keys ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 CreateArrayIterator (O,key ) を返す。
23.1.3.20 Array.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
このメソッドはsearchElementを配列の要素と降順で比較し、
オプションの第2引数fromIndexは配列の長さから1を引いた値がデフォルトです（つまり配列全体を検索）。これが配列の長さ以上の場合は配列全体が検索されます。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - len = 0 の場合、
-1 𝔽 を返す。 - fromIndex が存在する場合、n を ?
ToIntegerOrInfinity (fromIndex) とし、存在しない場合はn を len - 1 とする。 - n = -∞ の場合、
-1 𝔽 を返す。 - n ≥ 0 の場合、
- k を
min (n, len - 1) とする。
- k を
- それ以外の場合、
- k を len + n とする。
- k ≥ 0 の間、繰り返す:
- Pk を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (O, Pk) とする。 - kPresent が
true の場合、- elementK を ?
Get (O, Pk) とする。 IsStrictlyEqual (searchElement, elementK) がtrue の場合、𝔽 (k) を返す。
- elementK を ?
- k を k - 1 に設定する。
- Pk を !
-1 𝔽 を返す。
このメソッドは意図的にジェネリックです。
23.1.3.21 Array.prototype.map ( callback [ , thisArg ] )
callbackは3つの引数を受け取る関数である必要があります。mapは配列内の各要素に対して昇順でcallbackを1回ずつ呼び出し、その結果から新しい配列を作成します。callbackは実際に存在する配列の要素に対してのみ呼び出され、欠損要素には呼び出されません。
thisArgパラメータが指定された場合、各callback呼び出しの
callbackは、要素の値、要素のインデックス、走査対象のオブジェクトの3つの引数で呼び出されます。
mapは呼び出し元のオブジェクトを直接変更しませんが、callbackの呼び出しによってオブジェクトが変更される可能性があります。
mapが処理する要素の範囲は、最初のcallback呼び出し前に決まります。mapの呼び出し開始後に配列に追加された要素はcallbackによって訪問されません。既存の配列要素が変更された場合、その値はmapが訪問した時点の値になります。呼び出し開始後かつ訪問前に削除された要素は訪問されません。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- A を ?
ArraySpeciesCreate (O, len) とする。 - k を 0 とする。
- k < len の間、繰り返す:
- Pk を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (O, Pk) とする。 - kPresent が
true の場合、- kValue を ?
Get (O, Pk) とする。 - mappedValue を ?
Call (callback, thisArg, « kValue,𝔽 (k), O ») とする。 - ?
CreateDataPropertyOrThrow (A, Pk, mappedValue) を実行する。
- kValue を ?
- k を k + 1 に設定する。
- Pk を !
- A を返す。
このメソッドは意図的にジェネリックです。
23.1.3.22 Array.prototype.pop ( )
このメソッドは配列の最後の要素を削除し、その要素を返します。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - len = 0 の場合、
- ?
Set (O,"length" ,+0 𝔽,true ) を実行する。 undefined を返す。
- ?
- それ以外の場合、
このメソッドは意図的にジェネリックです。
23.1.3.23 Array.prototype.push ( ...items )
このメソッドは引数を配列の末尾に、現れる順番で追加します。新しい配列の長さを返します。
このメソッドは呼び出されたとき、以下の手順を実行します:
このメソッドの
このメソッドは意図的にジェネリックです。
23.1.3.24 Array.prototype.reduce ( callback [ , initialValue ] )
callbackは4つの引数を取る関数であるべきです。reduceは配列に存在する最初の要素の後の各要素に対して、昇順で一度ずつコールバック関数を呼びます。
callbackは4つの引数で呼び出されます:
previousValue（前回のcallback呼び出しの値）、currentValue（現在の要素の値）、currentIndex、および走査対象のオブジェクト。最初の呼び出し時、previousValueとcurrentValueは2通りの値になることがあります。reduceの呼び出しでinitialValueが指定されている場合は、previousValueがinitialValue、currentValueが配列の最初の値になります。initialValueが指定されていない場合は、previousValueが配列の最初の値、currentValueが2番目の値になります。配列に要素がなくinitialValueも指定されていない場合は
reduceは呼び出し元のオブジェクトを直接変更しませんが、callbackの呼び出しによってオブジェクトが変更される可能性があります。
reduceが処理する要素の範囲は、最初のcallback呼び出し前に決まります。reduceの呼び出し開始後に配列に追加された要素はcallbackによって訪問されません。既存の配列要素が変更された場合、その値はreduceが訪問した時点の値になります。呼び出し開始後かつ訪問前に削除された要素は訪問されません。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- len = 0 かつ initialValue
が存在しない場合、
TypeError 例外を投げる。 - k を 0 とする。
- accumulator を
undefined とする。 - initialValue が存在する場合、
- accumulator を initialValue に設定する。
- それ以外の場合、
- kPresent を
false とする。 - kPresent が
false かつ k < len の間、繰り返す:- Pk を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (O, Pk) に設定する。 - kPresent が
true の場合、- accumulator を ?
Get (O, Pk) に設定する。
- accumulator を ?
- k を k + 1 に設定する。
- Pk を !
- kPresent が
false の場合、TypeError 例外を投げる。
- kPresent を
- k < len の間、繰り返す:
- accumulator を返す。
このメソッドは意図的にジェネリックです。
23.1.3.25 Array.prototype.reduceRight ( callback [ , initialValue ] )
callbackは4つの引数を取る関数であるべきです。reduceRightは配列に存在する最初の要素の後の各要素に対して、降順で一度ずつコールバック関数を呼びます。
callbackは4つの引数で呼び出されます:
previousValue（前回のcallback呼び出しの値）、currentValue（現在の要素の値）、currentIndex、および走査対象のオブジェクト。最初の呼び出し時、previousValueとcurrentValueは2通りの値になることがあります。reduceRightの呼び出しでinitialValueが指定されている場合は、previousValueがinitialValue、currentValueが配列の最後の値になります。initialValueが指定されていない場合は、previousValueが配列の最後の値、currentValueが最後から2番目の値になります。配列に要素がなくinitialValueも指定されていない場合は
reduceRightは呼び出し元のオブジェクトを直接変更しませんが、callbackの呼び出しによってオブジェクトが変更される可能性があります。
reduceRightが処理する要素の範囲は、最初のcallback呼び出し前に決まります。reduceRightの呼び出し開始後に配列に追加された要素はcallbackによって訪問されません。既存の配列要素がcallbackによって変更された場合、その値はreduceRightが訪問した時点の値になります。呼び出し開始後かつ訪問前に削除された要素は訪問されません。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- len = 0 かつ initialValue
が存在しない場合、
TypeError 例外を投げる。 - k を len - 1 とする。
- accumulator を
undefined とする。 - initialValue が存在する場合、
- accumulator を initialValue に設定する。
- それ以外の場合、
- kPresent を
false とする。 - kPresent が
false かつ k ≥ 0 の間、繰り返す:- Pk を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (O, Pk) に設定する。 - kPresent が
true の場合、- accumulator を ?
Get (O, Pk) に設定する。
- accumulator を ?
- k を k - 1 に設定する。
- Pk を !
- kPresent が
false の場合、TypeError 例外を投げる。
- kPresent を
- k ≥ 0 の間、繰り返す:
- accumulator を返す。
このメソッドは意図的にジェネリックです。
23.1.3.26 Array.prototype.reverse ( )
このメソッドは配列の要素の順序を逆転するように並び替えます。逆転した配列を返します。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - middle を
floor (len / 2) とする。 - lower を 0 とする。
- lower ≠ middle の間、繰り返す:
- upper を len - lower - 1 とする。
- upperP を !
ToString (𝔽 (upper)) とする。 - lowerP を !
ToString (𝔽 (lower)) とする。 - lowerExists を ?
HasProperty (O, lowerP) に設定する。 - lowerExists が
true の場合、- lowerValue を ?
Get (O, lowerP) に設定する。
- lowerValue を ?
- upperExists を ?
HasProperty (O, upperP) に設定する。 - upperExists が
true の場合、- upperValue を ?
Get (O, upperP) に設定する。
- upperValue を ?
- lowerExists が
true かつ upperExists がtrue の場合、 - それ以外で lowerExists が
false かつ upperExists がtrue の場合、- ?
Set (O, lowerP, upperValue,true ) を実行する。 - ?
DeletePropertyOrThrow (O, upperP) を実行する。
- ?
- それ以外で lowerExists が
true かつ upperExists がfalse の場合、- ?
DeletePropertyOrThrow (O, lowerP) を実行する。 - ?
Set (O, upperP, lowerValue,true ) を実行する。
- ?
- それ以外、
アサート : lowerExists と upperExists の両方がfalse である。- 注: 何も行う必要はありません。
- lower を lower + 1 に設定する。
- O を返す。
このメソッドは意図的にジェネリックです。
23.1.3.27 Array.prototype.shift ( )
このメソッドは配列の最初の要素を削除し、その要素を返します。
呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - len = 0 の場合、
- ?
Set (O,"length" ,+0 𝔽,true ) を実行する。 undefined を返す。
- ?
- first を ?
Get (O,"0" ) とする。 - k を 1 とする。
- k < len の間、繰り返す:
- from を !
ToString (𝔽 (k)) とする。 - to を !
ToString (𝔽 (k - 1)) とする。 - fromPresent を ?
HasProperty (O, from) に設定する。 - fromPresent が
true の場合、 - それ以外、
アサート : fromPresent はfalse 。- ?
DeletePropertyOrThrow (O, to) を実行する。
- k を k + 1 に設定する。
- from を !
- ?
DeletePropertyOrThrow (O, !ToString (𝔽 (len - 1))) を実行する。 - ?
Set (O,"length" ,𝔽 (len - 1),true ) を実行する。 - first を返す。
このメソッドは意図的にジェネリックです。
23.1.3.28 Array.prototype.slice ( start, end )
このメソッドは、配列のstart番目の要素からend番目の要素（endは含まない）までの要素を含む配列を返します。endが
呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、k を 0 とする。
- それ以外で relativeStart < 0 の場合、k を
max (len + relativeStart, 0) とする。 - それ以外の場合、k を
min (relativeStart, len) とする。 - end が
undefined の場合、relativeEnd を len とし、それ以外は relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、final を 0 とする。
- それ以外で relativeEnd < 0 の場合、final を
max (len + relativeEnd, 0) とする。 - それ以外の場合、final を
min (relativeEnd, len) とする。 - count を
max (final - k, 0) とする。 - A を ?
ArraySpeciesCreate (O, count) とする。 - n を 0 とする。
- k < final の間、繰り返す:
- Pk を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (O, Pk) とする。 - kPresent が
true の場合、- kValue を ?
Get (O, Pk) とする。 - ?
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), kValue) を実行する。
- kValue を ?
- k を k + 1 に設定する。
- n を n + 1 に設定する。
- Pk を !
- ?
Set (A,"length" ,𝔽 (n),true ) を実行する。 - A を返す。
手順
このメソッドは意図的にジェネリックです。
23.1.3.29 Array.prototype.some ( callback [ , thisArg ] )
callbackは3つの引数を受け取り、Boolean値に変換可能な値を返す関数である必要があります。someは配列内の各要素に対して昇順でcallbackを1回ずつ呼び出し、callbackがsomeは直ちにsomeは
thisArgパラメータが指定された場合、各callback呼び出しの
callbackは、要素の値、要素のインデックス、走査対象のオブジェクトの3つの引数で呼び出されます。
someは呼び出し元のオブジェクトを直接変更しませんが、callbackの呼び出しによってオブジェクトが変更される可能性があります。
someが処理する要素の範囲は、最初のcallback呼び出し前に決まります。someの呼び出し開始後に配列に追加された要素はcallbackによって訪問されません。既存の配列要素が変更された場合、その値はsomeが訪問した時点の値になります。呼び出し開始後かつ訪問前に削除された要素は訪問されません。someは数学における「存在」の量化子のように振る舞います。特に、空配列の場合は
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- k を 0 とする。
- k < len の間、繰り返す:
false を返す。
このメソッドは意図的にジェネリックです。
23.1.3.30 Array.prototype.sort ( comparator )
このメソッドは配列の要素をソートします。comparatorが
呼び出されたとき、以下の手順を実行します:
-
comparatorが
undefined でなくIsCallable (comparator)がfalse なら、TypeError 例外を投げる。 - obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - SortCompare を新しい
抽象クロージャ （引数(x, y)、comparatorをキャプチャ）とし、呼び出し時に以下の手順を実行する:- ?
CompareArrayElements (x, y, comparator) を返す。
- ?
- sortedList を ?
SortIndexedProperties (obj, len, SortCompare,skip-holes ) とする。 - itemCount を sortedList の要素数とする。
- j を 0 とする。
- j < itemCount の間、繰り返す:
- 注: 手順
SortIndexedProperties （手順5 ）はskip-holes を使います。残りのインデックスは検出され並べ替えから除外されたホールの数を保持するため削除されます。 - j < len の間、繰り返す:
- ?
DeletePropertyOrThrow (obj, !ToString (𝔽 (j))) を実行する。 - j を j + 1 に設定する。
- ?
- obj を返す。
存在しないプロパティ値は常に
手順
このメソッドは意図的にジェネリックです。
23.1.3.30.1 SortIndexedProperties ( obj, len, SortCompare, holes )
抽象操作 SortIndexedProperties は、引数 obj（オブジェクト）、len（非負の
- items を新しい空の
List とする。 - k を 0 とする。
- k < len の間、繰り返す:
- Pk を !
ToString (𝔽 (k)) とする。 - holesが
skip-holes なら、- kRead を ?
HasProperty (obj, Pk) に設定する。
- kRead を ?
- それ以外の場合、
アサート : holes はread-through-holes である。- kRead を
true に設定する。
- kRead が
true の場合、- kValue を ?
Get (obj, Pk) に設定する。 - items に kValue を追加する。
- kValue を ?
- k を k + 1 に設定する。
- Pk を !
- itemsを
実装定義 の順序でSortCompareを呼び出してソートする。いずれかの呼び出しがabrupt completion（例外） を返した場合、以降の呼び出しを行わずそのCompletion Record を返す。 - items を返す。
sort orderは、上記アルゴリズムの手順
-
非負の
整数 （itemCount未満）の数学的な順列πが存在し、itemCount未満のすべての非負の整数 jについて、要素old[j] はnew[π(j)] と完全に同じである。 -
そして、itemCount未満の非負の
整数 jとkについて、もしℝ (SortCompare(old[j], old[k])) < 0π(j) < π(k) である。 -
さらに、itemCount未満の非負の
整数 jとkについて、j < kのとき、もしℝ (SortCompare(old[j], old[k])) = 0π(j) < π(k) 、すなわちソートは安定である。
ここで
抽象クロージャまたは関数comparatorは、値集合Sに対して下記要件がすべて満たされるとき、一貫性のある比較関数です。Sの値a、b、c（同じ値であってもよい）について、
-
comparator(a,
b)を呼び出すと、同じaとbに対して常に同じ値vを返す。さらに、vは
Number型 であり、vはNaN でない。これは、a <C b、a =C b、a >C bのいずれかが常に成り立つことを意味する。 - comparator(a, b)の呼び出しは、objやobjのプロトタイプチェーン上の他のオブジェクトを変更しない。
- a =C a（反射律）
- a =C bならb =C a（対称律）
- a =C bかつb =C cならa =C c（=の推移律）
- a <C bかつb <C cならa <C c（<の推移律）
- a >C bかつb >C cならa >C c（>の推移律）
上記条件は、comparatorが集合Sを同値類に分割し、それらの同値類を全順序付けすることを保証するために必要十分です。
23.1.3.30.2 CompareArrayElements ( x, y, comparator )
抽象操作 CompareArrayElements は、引数 x（
- xとyが両方
undefined なら、+0 𝔽を返す。 - xが
undefined なら、1 𝔽を返す。 - yが
undefined なら、-1 𝔽を返す。 - comparatorが
undefined でない場合、 - xString を ?
ToString (x) に設定する。 - yString を ?
ToString (y) に設定する。 - xSmaller を !
IsLessThan (xString, yString,true ) に設定する。 - xSmallerが
true なら-1 𝔽を返す。 - ySmaller を !
IsLessThan (yString, xString,true ) に設定する。 - ySmallerが
true なら1 𝔽を返す。 +0 𝔽を返す。
23.1.3.31 Array.prototype.splice ( start, deleteCount, ...items )
このメソッドは、配列の
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、actualStart を 0 とする。
- それ以外で relativeStart < 0 の場合、actualStart を
max (len + relativeStart, 0) とする。 - それ以外の場合、actualStart を
min (relativeStart, len) とする。 - itemCount を items の要素数とする。
- startが指定されていない場合、
- actualDeleteCount を 0 とする。
- それ以外で deleteCountが指定されていない場合、
- actualDeleteCount を len - actualStart とする。
- それ以外の場合、
- dc を ?
ToIntegerOrInfinity (deleteCount) とする。 - actualDeleteCount を
clamping でdcを0〜len - actualStartの範囲に丸めた値とする。
- dc を ?
- len + itemCount - actualDeleteCount >
253 - 1 の場合、
TypeError 例外を投げる。 - A を ?
ArraySpeciesCreate (O, actualDeleteCount) とする。 - k を 0 とする。
- k < actualDeleteCount の間、繰り返す:
- from を !
ToString (𝔽 (actualStart + k)) とする。 - ?
HasProperty (O, from) がtrue の場合、- fromValue を ?
Get (O, from) とする。 - ?
CreateDataPropertyOrThrow (A, !ToString (𝔽 (k)), fromValue) を実行する。
- fromValue を ?
- k を k + 1 に設定する。
- from を !
- ?
Set (A,"length" ,𝔽 (actualDeleteCount),true ) を実行する。 - itemCount < actualDeleteCount の場合、
- k を actualStart に設定する。
- k < (len -
actualDeleteCount) の間、繰り返す:
- from を !
ToString (𝔽 (k + actualDeleteCount)) とする。 - to を !
ToString (𝔽 (k + itemCount)) とする。 - ?
HasProperty (O, from) がtrue の場合、 - それ以外の場合、
- ?
DeletePropertyOrThrow (O, to) を実行する。
- ?
- k を k + 1 に設定する。
- from を !
- k を len に設定する。
- k > (len -
actualDeleteCount + itemCount) の間、繰り返す:
- ?
DeletePropertyOrThrow (O, !ToString (𝔽 (k - 1))) を実行する。 - k を k - 1 に設定する。
- ?
- それ以外で itemCount > actualDeleteCount の場合、
- k を (len - actualDeleteCount) に設定する。
- k > actualStart の間、繰り返す:
- from を !
ToString (𝔽 (k + actualDeleteCount - 1)) とする。 - to を !
ToString (𝔽 (k + itemCount - 1)) とする。 - ?
HasProperty (O, from) がtrue の場合、 - それ以外の場合、
- ?
DeletePropertyOrThrow (O, to) を実行する。
- ?
- k を k - 1 に設定する。
- from を !
- k を actualStart に設定する。
- items の各要素 E について、
- ?
Set (O,"length" ,𝔽 (len - actualDeleteCount + itemCount),true ) を実行する。 - A を返す。
このメソッドは意図的にジェネリックです。
23.1.3.32 Array.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMAScript 実装が ECMA-402 国際化 API を含む場合、このメソッドは ECMA-402 仕様で定められた通りに実装されなければなりません。ECMA-402 API を含まない ECMAScript 実装の場合、以下の仕様が適用されます。
ECMA-402 の初版にはこのメソッドの代替仕様は含まれていませんでした。
このメソッドのオプション引数の意味は ECMA-402 仕様で定義されています。ECMA-402 をサポートしない実装は、これらの引数位置を他の用途に使ってはなりません。
このメソッドは呼び出されたとき、以下の手順を実行します:
- array を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (array) とする。 - separator を
実装定義 のリスト区切り文字列値（ホスト環境 の現在のロケールに応じる。例:", " ）とする。 - R を空文字列とする。
- k を 0 とする。
- k < len の間、繰り返す:
- R を返す。
このメソッドは、配列の各要素のtoLocaleStringメソッドで文字列化し、それらをtoStringと類似しますが、ホスト環境の現在のロケールの慣習に従ったロケール依存の結果を返すことを意図しています。
このメソッドは意図的にジェネリックです。
23.1.3.33 Array.prototype.toReversed ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - A を ?
ArrayCreate (len) とする。 - k を 0 とする。
- k < len の間、繰り返す:
- A を返す。
23.1.3.34 Array.prototype.toSorted ( comparator )
このメソッドは呼び出されたとき、以下の手順を実行します:
- comparatorが
undefined でなくIsCallable (comparator)がfalse なら、TypeError 例外を投げる。 - O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - A を ?
ArrayCreate (len) とする。 - SortCompare を新しい
抽象クロージャ （引数(x, y)、comparatorをキャプチャ）とし、呼び出し時に以下の手順を実行する:- ?
CompareArrayElements (x, y, comparator) を返す。
- ?
- sortedList を ?
SortIndexedProperties (O, len, SortCompare,read-through-holes ) とする。 - j を 0 とする。
- j < len の間、繰り返す:
- !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (j)), sortedList[j]) を実行する。 - j を j + 1 に設定する。
- !
- A を返す。
23.1.3.35 Array.prototype.toSpliced ( start, skipCount, ...items )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、actualStart を 0 とする。
- それ以外で relativeStart < 0 の場合、actualStart を
max (len + relativeStart, 0) とする。 - それ以外の場合、actualStart を
min (relativeStart, len) とする。 - insertCount を items の要素数とする。
- startが指定されていない場合、
- actualSkipCount を 0 とする。
- それ以外で skipCountが指定されていない場合、
- actualSkipCount を len - actualStart とする。
- それ以外の場合、
- sc を ?
ToIntegerOrInfinity (skipCount) とする。 - actualSkipCount を
clamping でscを0〜len - actualStartの範囲に丸めた値とする。
- sc を ?
- newLen を len + insertCount - actualSkipCount とする。
- newLen > 253 - 1 の場合、
TypeError 例外を投げる。 - A を ?
ArrayCreate (newLen) とする。 - i を 0 とする。
- r を actualStart + actualSkipCount とする。
- i < actualStart の間、繰り返す:
- Pi を !
ToString (𝔽 (i)) とする。 - iValue を ?
Get (O, Pi) とする。 - !
CreateDataPropertyOrThrow (A, Pi, iValue) を実行する。 - i を i + 1 に設定する。
- Pi を !
- items の各要素 E について、
- Pi を !
ToString (𝔽 (i)) とする。 - !
CreateDataPropertyOrThrow (A, Pi, E) を実行する。 - i を i + 1 に設定する。
- Pi を !
- i < newLen の間、繰り返す:
- A を返す。
23.1.3.36 Array.prototype.toString ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- array を ?
ToObject (this 値) とする。 - func を ?
Get (array,"join" ) とする。 IsCallable (func) がfalse なら、func を組み込み関数 %Object.prototype.toString% に設定する。- ?
Call (func, array) を返す。
このメソッドは意図的にジェネリックです。
23.1.3.37 Array.prototype.unshift ( ...items )
このメソッドは、引数を配列の先頭に追加し、配列内の順序は引数リストで現れる順序と同じになります。
呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - argCount を items の要素数とする。
- argCount > 0 の場合、
- len + argCount > 253 - 1
の場合、
TypeError 例外を投げる。 - k を len に設定する。
- k > 0 の間、繰り返す:
- from を !
ToString (𝔽 (k - 1)) とする。 - to を !
ToString (𝔽 (k + argCount - 1)) とする。 - fromPresent を ?
HasProperty (O, from) に設定する。 - fromPresent が
true の場合、 - それ以外の場合、
アサート : fromPresent はfalse 。- ?
DeletePropertyOrThrow (O, to) を実行する。
- k を k - 1 に設定する。
- from を !
- j を
+0 𝔽 に設定する。 - items の各要素 E について、
- len + argCount > 253 - 1
の場合、
- ?
Set (O,"length" ,𝔽 (len + argCount),true ) を実行する。 𝔽 (len + argCount) を返す。
このメソッドの
このメソッドは意図的にジェネリックです。
23.1.3.38 Array.prototype.values ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 CreateArrayIterator (O,value ) を返す。
23.1.3.39 Array.prototype.with ( index, value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (O) とする。 - relativeIndex を ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0 の場合、actualIndex を relativeIndex とする。
- それ以外の場合、actualIndex を len + relativeIndex とする。
- actualIndex ≥ len または actualIndex < 0
の場合、
RangeError 例外を投げる。 - A を ?
ArrayCreate (len) とする。 - k を 0 とする。
- k < len の間、繰り返す:
- Pk を !
ToString (𝔽 (k)) とする。 - k = actualIndex の場合、fromValue を value とする。
- それ以外の場合、fromValue を ?
Get (O, Pk) とする。 - !
CreateDataPropertyOrThrow (A, Pk, fromValue) を実行する。 - k を k + 1 に設定する。
- Pk を !
- A を返す。
23.1.3.40 Array.prototype [ %Symbol.iterator% ] ( )
23.1.3.41 Array.prototype [ %Symbol.unscopables% ]
- unscopableList を
OrdinaryObjectCreate (null ) とする。 - !
CreateDataPropertyOrThrow (unscopableList,"at" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"copyWithin" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"entries" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"fill" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"find" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"findIndex" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"findLast" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"findLastIndex" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"flat" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"flatMap" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"includes" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"keys" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"toReversed" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"toSorted" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"toSpliced" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"values" ,true ) を実行する。 - unscopableList を返す。
このプロパティは属性 { [[Writable]]:
このオブジェクトの独自プロパティ名は、ECMAScript 2015
仕様より前にはArray.prototypeの標準プロパティとして含まれていなかったプロパティ名です。これらの名前は、with文バインディング用途では無視されます。これは、外側スコープでこれらの名前をバインディングとして使い、with文のバインディングオブジェクトがArrayである場合、その動作を既存コードの互換性のために維持するためです。
23.1.4 配列インスタンスのプロパティ
配列インスタンスは
配列インスタンスは
23.1.4.1 length
配列インスタンスの
23.1.5 配列イテレータオブジェクト
配列イテレータは、特定の配列インスタンスオブジェクト上の特定の反復を表すオブジェクトです。配列イテレータオブジェクトのための名前付き
23.1.5.1 CreateArrayIterator ( array, kind )
抽象操作 CreateArrayIterator
は、引数array（オブジェクト）とkind（
- iterator を
OrdinaryObjectCreate (%ArrayIteratorPrototype% , « [[IteratedArrayLike]], [[ArrayLikeNextIndex]], [[ArrayLikeIterationKind]] » ) とする。 - iterator.[[IteratedArrayLike]] に array を設定する。
- iterator.[[ArrayLikeNextIndex]] に 0 を設定する。
- iterator.[[ArrayLikeIterationKind]] に kind を設定する。
- iterator を返す。
23.1.5.2 %ArrayIteratorPrototype% オブジェクト
%ArrayIteratorPrototype%オブジェクトは以下の特性を持ちます:
- 全ての
配列イテレータオブジェクト が継承するプロパティを持つ。 通常のオブジェクト である。- [[Prototype]]内部スロットの値は
%Iterator.prototype% である。 - 以下のプロパティを持つ:
23.1.5.2.1 %ArrayIteratorPrototype%.next ( )
- O を
this 値とする。 - Oが
オブジェクトでない 場合、TypeError 例外を投げる。 - Oが
配列イテレータ インスタンスの全ての内部スロットを持たない場合（23.1.5.3 ）、TypeError 例外を投げる。 - array を O.[[IteratedArrayLike]] とする。
- arrayが
undefined なら、CreateIteratorResultObject (undefined ,true ) を返す。 - index を O.[[ArrayLikeNextIndex]] とする。
- kind を O.[[ArrayLikeIterationKind]] とする。
- arrayが[[TypedArrayName]]内部スロットを持つ場合、
- taRecord を
MakeTypedArrayWithBufferWitnessRecord (array,seq-cst ) とする。 IsTypedArrayOutOfBounds (taRecord) がtrue なら、TypeError 例外を投げる。- len を
TypedArrayLength (taRecord) とする。
- taRecord を
- それ以外の場合、
- len を ?
LengthOfArrayLike (array) とする。
- len を ?
- index ≥ len の場合、
- O.[[IteratedArrayLike]] を
undefined に設定する。 CreateIteratorResultObject (undefined ,true ) を返す。
- O.[[IteratedArrayLike]] を
- O.[[ArrayLikeNextIndex]] を index + 1 に設定する。
- indexNumber を
𝔽 (index) とする。 - kind が
key の場合、- result を indexNumber とする。
- それ以外の場合、
- elementKey を !
ToString (indexNumber) とする。 - elementValue を ?
Get (array, elementKey) とする。 - kind が
value の場合、- result を elementValue とする。
- それ以外の場合、
アサート : kind はkey+value である。- result を
CreateArrayFromList (« indexNumber, elementValue » ) とする。
- elementKey を !
CreateIteratorResultObject (result,false ) を返す。
23.1.5.2.2 %ArrayIteratorPrototype% [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
23.1.5.3 配列イテレータインスタンスのプロパティ
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[IteratedArrayLike]] |
オブジェクトまたは |
反復されている |
| [[ArrayLikeNextIndex]] |
非負の |
この |
| [[ArrayLikeIterationKind]] |
|
反復の各要素に対して何を返すかを識別する値。 |
23.2 TypedArray オブジェクト
TypedArrayは、基礎となるバイナリデータバッファ（
|
|
要素型 | 要素サイズ | 変換操作 | 説明 |
|---|---|---|---|---|
|
Int8Array %Int8Array% |
|
1 |
|
8ビット 2の補数の符号付き |
|
Uint8Array %Uint8Array% |
|
1 |
|
8ビット符号なし |
|
Uint8ClampedArray %Uint8ClampedArray% |
|
1 |
|
8ビット符号なし |
|
Int16Array %Int16Array% |
|
2 |
|
16ビット 2の補数の符号付き |
|
Uint16Array %Uint16Array% |
|
2 |
|
16ビット符号なし |
|
Int32Array %Int32Array% |
|
4 |
|
32ビット 2の補数の符号付き |
|
Uint32Array %Uint32Array% |
|
4 |
|
32ビット符号なし |
|
BigInt64Array %BigInt64Array% |
|
8 |
|
64ビット 2の補数の符号付き |
|
BigUint64Array %BigUint64Array% |
|
8 |
|
64ビット符号なし |
|
Float16Array %Float16Array% |
|
2 | 16ビット IEEE浮動小数点 | |
|
Float32Array %Float32Array% |
|
4 | 32ビット IEEE浮動小数点 | |
|
Float64Array %Float64Array% |
|
8 | 64ビット IEEE浮動小数点 |
以下の定義では、TypedArrayへの参照は上記表から該当する
23.2.1 %TypedArray% 組み込みオブジェクト
%TypedArray% 組み込みオブジェクトは以下の特性を持ちます:
- 全ての TypedArray
コンストラクタ オブジェクトが継承する関数オブジェクト のコンストラクタ です。 - 対応するプロトタイプオブジェクトとともに、全ての TypedArray
コンストラクタ およびそのインスタンスが継承する共通プロパティを提供します。 - グローバル名を持たず、
グローバルオブジェクト のプロパティとして現れません。 - 様々な TypedArray
コンストラクタ の抽象的スーパークラスとして機能します。 - 抽象クラス
コンストラクタ であるため、呼び出すとエラーを投げます。TypedArrayコンストラクタ はこれにsuperコールを行いません。
23.2.1.1 %TypedArray% ( )
この関数は呼び出されたとき、以下の手順を実行します:
TypeError 例外を投げる。
この関数の
23.2.2 %TypedArray% 組み込みオブジェクトのプロパティ
- [[Prototype]] 内部スロットの値は
%Function.prototype% です。 "name" プロパティの値は"TypedArray" です。- 以下のプロパティを持ちます:
23.2.2.1 %TypedArray%.from ( source [ , mapper [ , thisArg ] ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- C を
this 値とする。 IsConstructor (C) がfalse なら、TypeError 例外を投げる。- mapper が
undefined の場合、- mapping を
false に設定する。
- mapping を
- それ以外の場合、
IsCallable (mapper) がfalse なら、TypeError 例外を投げる。- mapping を
true に設定する。
- usingIterator を ?
GetMethod (source,%Symbol.iterator% ) とする。 - usingIterator が
undefined でない場合、- values を ?
IteratorToList (?GetIteratorFromMethod (source, usingIterator)) とする。 - len を values の要素数とする。
- targetObj を ?
TypedArrayCreateFromConstructor (C, «𝔽 (len) » ) とする。 - k を 0 に設定する。
- k < len の間、繰り返す:
アサート : values は空のList となる。- targetObj を返す。
- values を ?
- 注: source は
イテラブルオブジェクト ではないため、既に配列ライクオブジェクト とみなす。 - arrayLike を !
ToObject (source) とする。 - len を ?
LengthOfArrayLike (arrayLike) とする。 - targetObj を ?
TypedArrayCreateFromConstructor (C, «𝔽 (len) » ) とする。 - k を 0 に設定する。
- k < len の間、繰り返す:
- targetObj を返す。
23.2.2.2 %TypedArray%.of ( ...items )
このメソッドは呼び出されたとき、以下の手順を実行します:
- len を items の要素数とする。
- C を
this 値とする。 IsConstructor (C) がfalse なら、TypeError 例外を投げる。- newObj を ?
TypedArrayCreateFromConstructor (C, «𝔽 (len) » ) とする。 - k を 0 に設定する。
- k < len の間、繰り返す:
- newObj を返す。
23.2.2.3 %TypedArray%.prototype
.prototype
の初期値は
このプロパティは属性 { [[Writable]]:
23.2.2.4 get %TypedArray% [ %Symbol.species% ]
[%Symbol.species%]
は
this 値を返す。
この関数の
23.2.3 %TypedArray% プロトタイプオブジェクトのプロパティ
%TypedArray% プロトタイプオブジェクトは以下の特性を持ちます:
- [[Prototype]] 内部スロットの値は
%Object.prototype% です。 - %TypedArray.prototype%である。
通常のオブジェクト である。- TypedArrayインスタンスオブジェクトに固有の[[ViewedArrayBuffer]]やその他の内部スロットは持たない。
23.2.3.1 %TypedArray%.prototype.at ( index )
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - relativeIndex を ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0 の場合、
- k を relativeIndex に設定する。
- それ以外の場合、
- k を len + relativeIndex に設定する。
- k < 0 または k ≥ len
の場合、
undefined を返す。 - !
Get (O, !ToString (𝔽 (k))) を返す。
23.2.3.2 get %TypedArray%.prototype.buffer
.prototype.bufferは
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[TypedArrayName]]) を実行する。 Assert : O は [[ViewedArrayBuffer]] 内部スロットを持つ。- buffer を O.[[ViewedArrayBuffer]] に設定する。
- buffer を返す。
23.2.3.3 get %TypedArray%.prototype.byteLength
.prototype.byteLengthは
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[TypedArrayName]]) を実行する。 Assert : O は [[ViewedArrayBuffer]] 内部スロットを持つ。- taRecord を
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst ) とする。 - size を
TypedArrayByteLength (taRecord) とする。 𝔽 (size) を返す。
23.2.3.4 get %TypedArray%.prototype.byteOffset
.prototype.byteOffsetは
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[TypedArrayName]]) を実行する。 Assert : O は [[ViewedArrayBuffer]] 内部スロットを持つ。- taRecord を
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst ) とする。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、+0 𝔽 を返す。- offset を O.[[ByteOffset]] に設定する。
𝔽 (offset) を返す。
23.2.3.5 %TypedArray%.prototype.constructor
.prototype.constructor
の初期値は
23.2.3.6 %TypedArray%.prototype.copyWithin ( target, start [ , end ] )
このメソッドの引数の解釈と利用はArray.prototype.copyWithinと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - relativeTarget を ?
ToIntegerOrInfinity (target) とする。 - relativeTarget = -∞ の場合、targetIndex を 0 に設定する。
- それ以外で relativeTarget < 0 の場合、targetIndex を
max (len + relativeTarget, 0) に設定する。 - それ以外の場合、targetIndex を
min (relativeTarget, len) に設定する。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、startIndex を 0 に設定する。
- それ以外で relativeStart < 0 の場合、startIndex を
max (len + relativeStart, 0) に設定する。 - それ以外の場合、startIndex を
min (relativeStart, len) に設定する。 - end が
undefined の場合、relativeEnd を len とし、それ以外は relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、endIndex を 0 に設定する。
- それ以外で relativeEnd < 0 の場合、endIndex を
max (len + relativeEnd, 0) に設定する。 - それ以外の場合、endIndex を
min (relativeEnd, len) に設定する。 - count を
min (endIndex - startIndex, len - targetIndex) に設定する。 - count > 0 の場合、
- 注: コピーはソースデータのビットレベル符号化を保持する方法で行わなければなりません。
- buffer を O.[[ViewedArrayBuffer]] に設定する。
- taRecord を
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst ) に設定し直す。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外を投げる。- len を
TypedArrayLength (taRecord) に設定し直す。 - elementSize を
TypedArrayElementSize (O) に設定する。 - byteOffset を O.[[ByteOffset]] に設定する。
- bufferByteLimit を (len × elementSize) + byteOffset に設定する。
- toByteIndex を (targetIndex × elementSize) + byteOffset に設定する。
- fromByteIndex を (startIndex × elementSize) + byteOffset に設定する。
- countBytes を count × elementSize に設定する。
- fromByteIndex < toByteIndex かつ
toByteIndex < fromByteIndex + countBytes
の場合、
- direction を -1 に設定する。
- fromByteIndex を fromByteIndex + countBytes - 1 に設定する。
- toByteIndex を toByteIndex + countBytes - 1 に設定する。
- それ以外の場合、
- direction を 1 に設定する。
- countBytes > 0 の間、繰り返す:
- fromByteIndex < bufferByteLimit かつ
toByteIndex < bufferByteLimit の場合、
- value を
GetValueFromBuffer (buffer, fromByteIndex,uint8 ,true ,unordered ) に設定する。 SetValueInBuffer (buffer, toByteIndex,uint8 , value,true ,unordered ) を実行する。- fromByteIndex を fromByteIndex + direction に設定する。
- toByteIndex を toByteIndex + direction に設定する。
- countBytes を countBytes - 1 に設定する。
- value を
- それ以外の場合、
- countBytes を 0 に設定する。
- fromByteIndex < bufferByteLimit かつ
toByteIndex < bufferByteLimit の場合、
- O を返す。
23.2.3.7 %TypedArray%.prototype.entries ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
ValidateTypedArray (O,seq-cst ) を実行する。 CreateArrayIterator (O,key+value ) を返す。
23.2.3.8 %TypedArray%.prototype.every ( callback [ , thisArg ] )
このメソッドの引数の解釈と利用はArray.prototype.everyと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- k を 0 に設定する。
- k < len の間、繰り返す:
true を返す。
このメソッドはジェネリックではありません。
23.2.3.9 %TypedArray%.prototype.fill ( value [ , start [ , end ] ] )
このメソッドの引数の解釈と利用はArray.prototype.fillと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - O.[[ContentType]]
が
bigint の場合、value を ?ToBigInt (value) に設定する。 - それ以外の場合、value を ?
ToNumber (value) に設定する。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、startIndex を 0 に設定する。
- それ以外で relativeStart < 0 の場合、startIndex を
max (len + relativeStart, 0) に設定する。 - それ以外の場合、startIndex を
min (relativeStart, len) に設定する。 - end が
undefined の場合、relativeEnd を len とし、それ以外は relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、endIndex を 0 に設定する。
- それ以外で relativeEnd < 0 の場合、endIndex を
max (len + relativeEnd, 0) に設定する。 - それ以外の場合、endIndex を
min (relativeEnd, len) に設定する。 - taRecord を
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst ) に再設定する。 IsTypedArrayOutOfBounds (taRecord) がtrue なら、TypeError 例外を投げる。- len を
TypedArrayLength (taRecord) に再設定する。 - endIndex を
min (endIndex, len) に設定する。 - k を startIndex に設定する。
- k < endIndex の間、繰り返す:
- O を返す。
23.2.3.10 %TypedArray%.prototype.filter ( callback [ , thisArg ] )
このメソッドの引数の解釈と利用はArray.prototype.filterと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- kept を新しい空の
List とする。 - captured を 0 に設定する。
- k を 0 に設定する。
- k < len の間、繰り返す:
- A を ?
TypedArraySpeciesCreate (O, «𝔽 (captured) » ) とする。 - n を 0 に設定する。
- kept の各要素 e について、
- A を返す。
このメソッドはジェネリックではありません。
23.2.3.11 %TypedArray%.prototype.find ( predicate [ , thisArg ] )
このメソッドの引数の解釈と利用はArray.prototype.findと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - findRec を ?
FindViaPredicate (O, len,ascending , predicate, thisArg) とする。 - findRec.[[Value]] を返す。
このメソッドはジェネリックではありません。
23.2.3.12 %TypedArray%.prototype.findIndex ( predicate [ , thisArg ] )
このメソッドの引数の解釈と利用はArray.prototype.findIndexと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - findRec を ?
FindViaPredicate (O, len,ascending , predicate, thisArg) とする。 - findRec.[[Index]] を返す。
このメソッドはジェネリックではありません。
23.2.3.13 %TypedArray%.prototype.findLast ( predicate [ , thisArg ] )
このメソッドの引数の解釈と利用はArray.prototype.findLastと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - findRec を ?
FindViaPredicate (O, len,descending , predicate, thisArg) とする。 - findRec.[[Value]] を返す。
このメソッドはジェネリックではありません。
23.2.3.14 %TypedArray%.prototype.findLastIndex ( predicate [ , thisArg ] )
このメソッドの引数の解釈と利用はArray.prototype.findLastIndexと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - findRec を ?
FindViaPredicate (O, len,descending , predicate, thisArg) とする。 - findRec.[[Index]] を返す。
このメソッドはジェネリックではありません。
23.2.3.15 %TypedArray%.prototype.forEach ( callback [ , thisArg ] )
このメソッドの引数の解釈と利用はArray.prototype.forEachと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- k を 0 に設定する。
- k < len の間、繰り返す:
undefined を返す。
このメソッドはジェネリックではありません。
23.2.3.16 %TypedArray%.prototype.includes ( searchElement [ , fromIndex ] )
このメソッドの引数の解釈と利用はArray.prototype.includesと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - len = 0 の場合、
false を返す。 - n を ?
ToIntegerOrInfinity (fromIndex) とする。 Assert : fromIndex がundefined の場合、n は 0。- n = +∞ の場合、
false を返す。 - それ以外で n = -∞ の場合、n を 0 に設定する。
- n ≥ 0 の場合、
- k を n に設定する。
- それ以外の場合、
- k を len + n に設定する。
- k < 0 の場合、k を 0 に設定する。
- k < len の間、繰り返す:
- elementK を !
Get (O, !ToString (𝔽 (k))) に設定する。 SameValueZero (searchElement, elementK) がtrue の場合、true を返す。- k を k + 1 に設定する。
- elementK を !
false を返す。
このメソッドはジェネリックではありません。
23.2.3.17 %TypedArray%.prototype.indexOf ( searchElement [ , fromIndex ] )
このメソッドの引数の解釈と利用はArray.prototype.indexOfと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - len = 0 の場合、
-1 𝔽 を返す。 - n を ?
ToIntegerOrInfinity (fromIndex) とする。 Assert : fromIndex がundefined の場合、n は 0。- n = +∞ の場合、
-1 𝔽 を返す。 - それ以外で n = -∞ の場合、n を 0 に設定する。
- n ≥ 0 の場合、
- k を n に設定する。
- それ以外の場合、
- k を len + n に設定する。
- k < 0 の場合、k を 0 に設定する。
- k < len の間、繰り返す:
- Pk を !
ToString (𝔽 (k)) とする。 - kPresent を !
HasProperty (O, Pk) に設定する。 - kPresent が
true の場合、- elementK を !
Get (O, Pk) に設定する。 IsStrictlyEqual (searchElement, elementK) がtrue の場合、𝔽 (k) を返す。
- elementK を !
- k を k + 1 に設定する。
- Pk を !
-1 𝔽 を返す。
このメソッドはジェネリックではありません。
23.2.3.18 %TypedArray%.prototype.join ( separator )
このメソッドの引数の解釈と利用はArray.prototype.joinと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - separator が
undefined の場合、sep を"," に設定する。 - それ以外の場合、sep を ?
ToString (separator) に設定する。 - R を空文字列に設定する。
- k を 0 に設定する。
- k < len の間、繰り返す:
- R を返す。
このメソッドはジェネリックではありません。
23.2.3.19 %TypedArray%.prototype.keys ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
ValidateTypedArray (O,seq-cst ) を実行する。 CreateArrayIterator (O,key ) を返す。
23.2.3.20 %TypedArray%.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
このメソッドの引数の解釈と利用はArray.prototype.lastIndexOfと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - len = 0 の場合、
-1 𝔽 を返す。 - fromIndex が指定された場合、n を ?
ToIntegerOrInfinity (fromIndex) とし、そうでない場合 n を len - 1 に設定する。 - n = -∞ の場合、
-1 𝔽 を返す。 - n ≥ 0 の場合、
- k を
min (n, len - 1) に設定する。
- k を
- それ以外の場合、
- k を len + n に設定する。
- k ≥ 0 の間、繰り返す:
- Pk を !
ToString (𝔽 (k)) とする。 - kPresent を !
HasProperty (O, Pk) に設定する。 - kPresent が
true の場合、- elementK を !
Get (O, Pk) に設定する。 IsStrictlyEqual (searchElement, elementK) がtrue の場合、𝔽 (k) を返す。
- elementK を !
- k を k - 1 に設定する。
- Pk を !
-1 𝔽 を返す。
このメソッドはジェネリックではありません。
23.2.3.21 get %TypedArray%.prototype.length
.prototype.lengthは
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[TypedArrayName]]) を実行する。 Assert : O は [[ViewedArrayBuffer]] および [[ArrayLength]] 内部スロットを持つ。- taRecord を
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst ) に設定する。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、+0 𝔽 を返す。- length を
TypedArrayLength (taRecord) に設定する。 𝔽 (length) を返す。
この関数はジェネリックではありません。
23.2.3.22 %TypedArray%.prototype.map ( callback [ , thisArg ] )
このメソッドの引数の解釈と利用はArray.prototype.mapと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- A を ?
TypedArraySpeciesCreate (O, «𝔽 (len) » ) とする。 - k を 0 に設定する。
- k < len の間、繰り返す:
- A を返す。
このメソッドはジェネリックではありません。
23.2.3.23 %TypedArray%.prototype.reduce ( callback [ , initialValue ] )
このメソッドの引数の解釈と利用はArray.prototype.reduceと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- len = 0 かつ initialValue
が指定されていない場合、
TypeError 例外を投げる。 - k を 0 に設定する。
- accumulator を
undefined に設定する。 - initialValue が指定されている場合、
- accumulator を initialValue に設定する。
- それ以外の場合、
- k < len の間、繰り返す:
- accumulator を返す。
このメソッドはジェネリックではありません。
23.2.3.24 %TypedArray%.prototype.reduceRight ( callback [ , initialValue ] )
このメソッドの引数の解釈と利用はArray.prototype.reduceRightと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- len = 0 かつ initialValue
が指定されていない場合、
TypeError 例外を投げる。 - k を len - 1 に設定する。
- accumulator を
undefined に設定する。 - initialValue が指定されている場合、
- accumulator を initialValue に設定する。
- それ以外の場合、
- k ≥ 0 の間、繰り返す:
- accumulator を返す。
このメソッドはジェネリックではありません。
23.2.3.25 %TypedArray%.prototype.reverse ( )
このメソッドの引数の解釈と利用はArray.prototype.reverseと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - middle を
floor (len / 2) に設定する。 - lower を 0 に設定する。
- lower ≠ middle の間、繰り返す:
- O を返す。
このメソッドはジェネリックではありません。
23.2.3.26 %TypedArray%.prototype.set ( source [ , offset ] )
このメソッドはこの TypedArray に複数の値を設定し、値は source から読み取ります。詳細は source の型によって異なります。省略可能な offset は、この TypedArray の値を書き込む最初の要素インデックスを示します。省略時は 0 とみなされます。
呼び出されたとき、以下の手順を実行します:
- target を
this 値とする。 - ?
RequireInternalSlot (target, [[TypedArrayName]]) を実行する。 Assert : target は [[ViewedArrayBuffer]] 内部スロットを持つ。- targetOffset を ?
ToIntegerOrInfinity (offset) に設定する。 - targetOffset < 0 の場合、
RangeError 例外を投げる。 - source が
オブジェクト で [[TypedArrayName]] 内部スロットを持つ場合、- ?
SetTypedArrayFromTypedArray (target, targetOffset, source) を実行する。
- ?
- それ以外の場合、
- ?
SetTypedArrayFromArrayLike (target, targetOffset, source) を実行する。
- ?
undefined を返す。
このメソッドはジェネリックではありません。
23.2.3.26.1 SetTypedArrayFromArrayLike ( target, targetOffset, source )
抽象操作 SetTypedArrayFromArrayLike は、引数 target（
- targetRecord を
MakeTypedArrayWithBufferWitnessRecord (target,seq-cst ) に設定する。 IsTypedArrayOutOfBounds (targetRecord) がtrue の場合、TypeError 例外を投げる。- targetLength を
TypedArrayLength (targetRecord) に設定する。 - src を ?
ToObject (source) に設定する。 - srcLength を ?
LengthOfArrayLike (src) に設定する。 - targetOffset = +∞ の場合、
RangeError 例外を投げる。 - srcLength + targetOffset > targetLength
の場合、
RangeError 例外を投げる。 - k を 0 に設定する。
- k < srcLength の間、繰り返す:
- Pk を !
ToString (𝔽 (k)) に設定する。 - value を ?
Get (src, Pk) に設定する。 - targetIndex を
𝔽 (targetOffset + k) に設定する。 - ?
TypedArraySetElement (target, targetIndex, value) を実行する。 - k を k + 1 に設定する。
- Pk を !
unused を返す。
23.2.3.26.2 SetTypedArrayFromTypedArray ( target, targetOffset, source )
抽象操作 SetTypedArrayFromTypedArray は引数 target（
- targetBuffer を target.[[ViewedArrayBuffer]] に設定する。
- targetRecord を
MakeTypedArrayWithBufferWitnessRecord (target,seq-cst ) に設定する。 IsTypedArrayOutOfBounds (targetRecord) がtrue の場合、TypeError 例外を投げる。- targetLength を
TypedArrayLength (targetRecord) に設定する。 - srcBuffer を source.[[ViewedArrayBuffer]] に設定する。
- srcRecord を
MakeTypedArrayWithBufferWitnessRecord (source,seq-cst ) に設定する。 IsTypedArrayOutOfBounds (srcRecord) がtrue の場合、TypeError 例外を投げる。- srcLength を
TypedArrayLength (srcRecord) に設定する。 - targetType を
TypedArrayElementType (target) に設定する。 - targetElementSize を
TypedArrayElementSize (target) に設定する。 - targetByteOffset を target.[[ByteOffset]] に設定する。
- srcType を
TypedArrayElementType (source) に設定する。 - srcElementSize を
TypedArrayElementSize (source) に設定する。 - srcByteOffset を source.[[ByteOffset]] に設定する。
- targetOffset = +∞ の場合、
RangeError 例外を投げる。 - srcLength + targetOffset > targetLength
の場合、
RangeError 例外を投げる。 - target.[[ContentType]] が
source.[[ContentType]]
と異なる場合、
TypeError 例外を投げる。 IsSharedArrayBuffer (srcBuffer) がtrue かつIsSharedArrayBuffer (targetBuffer) がtrue かつsrcBuffer.[[ArrayBufferData]]がtargetBuffer.[[ArrayBufferData]]であるなら、sameSharedArrayBuffer をtrue に設定し、それ以外は sameSharedArrayBuffer をfalse に設定する。SameValue (srcBuffer, targetBuffer) がtrue または sameSharedArrayBuffer がtrue の場合、- srcByteLength を
TypedArrayByteLength (srcRecord) に設定する。 - srcBuffer を ?
CloneArrayBuffer (srcBuffer, srcByteOffset, srcByteLength) に設定する。 - srcByteIndex を 0 に設定する。
- srcByteLength を
- それ以外の場合、
- srcByteIndex を srcByteOffset に設定する。
- targetByteIndex を (targetOffset × targetElementSize) + targetByteOffset に設定する。
- limit を targetByteIndex + (targetElementSize × srcLength) に設定する。
- srcType が targetType の場合、
- 注: 転送はソースデータのビットレベル符号化を保持する方法で行わなければなりません。
- targetByteIndex < limit の間、繰り返す:
- value を
GetValueFromBuffer (srcBuffer, srcByteIndex,uint8 ,true ,unordered ) に設定する。 SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered ) を実行する。- srcByteIndex を srcByteIndex + 1 に設定する。
- targetByteIndex を targetByteIndex + 1 に設定する。
- value を
- それ以外の場合、
- targetByteIndex < limit の間、繰り返す:
- value を
GetValueFromBuffer (srcBuffer, srcByteIndex, srcType,true ,unordered ) に設定する。 SetValueInBuffer (targetBuffer, targetByteIndex, targetType, value,true ,unordered ) を実行する。- srcByteIndex を srcByteIndex + srcElementSize に設定する。
- targetByteIndex を targetByteIndex + targetElementSize に設定する。
- value を
- targetByteIndex < limit の間、繰り返す:
unused を返す。
23.2.3.27 %TypedArray%.prototype.slice ( start, end )
このメソッドの引数の解釈と利用はArray.prototype.sliceと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - srcArrayLength を
TypedArrayLength (taRecord) に設定する。 - relativeStart を ?
ToIntegerOrInfinity (start) に設定する。 - relativeStart = -∞ の場合、startIndex を 0 に設定する。
- それ以外で relativeStart < 0 の場合、startIndex を
max (srcArrayLength + relativeStart, 0) に設定する。 - それ以外の場合、startIndex を
min (relativeStart, srcArrayLength) に設定する。 - end が
undefined の場合、relativeEnd を srcArrayLength とし、それ以外は relativeEnd を ?ToIntegerOrInfinity (end) に設定する。 - relativeEnd = -∞ の場合、endIndex を 0 に設定する。
- それ以外で relativeEnd < 0 の場合、endIndex を
max (srcArrayLength + relativeEnd, 0) に設定する。 - それ以外の場合、endIndex を
min (relativeEnd, srcArrayLength) に設定する。 - countBytes を
max (endIndex - startIndex, 0) に設定する。 - A を ?
TypedArraySpeciesCreate (O, «𝔽 (countBytes) » ) に設定する。 - countBytes > 0 の場合、
- taRecord を
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst ) に再設定する。 IsTypedArrayOutOfBounds (taRecord) がtrue のとき、TypeError 例外を投げる。- endIndex を
min (endIndex,TypedArrayLength (taRecord)) に設定する。 - countBytes を
max (endIndex - startIndex, 0) に再設定する。 - srcType を
TypedArrayElementType (O) に設定する。 - targetType を
TypedArrayElementType (A) に設定する。 - srcType が targetType の場合、
- 注: 転送はソースデータのビットレベル符号化を保持する方法で行わなければなりません。
- srcBuffer を O.[[ViewedArrayBuffer]] に設定する。
- targetBuffer を A.[[ViewedArrayBuffer]] に設定する。
- elementSize を
TypedArrayElementSize (O) に設定する。 - srcByteOffset を O.[[ByteOffset]] に設定する。
- srcByteIndex を (startIndex × elementSize) + srcByteOffset に設定する。
- targetByteIndex を A.[[ByteOffset]] に設定する。
- endByteIndex を targetByteIndex + (countBytes × elementSize) に設定する。
- targetByteIndex <
endByteIndex の間、繰り返す:
- value を
GetValueFromBuffer (srcBuffer, srcByteIndex,uint8 ,true ,unordered ) に設定する。 SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered ) を実行する。- srcByteIndex を srcByteIndex + 1 に設定する。
- targetByteIndex を targetByteIndex + 1 に設定する。
- value を
- それ以外の場合、
- taRecord を
- A を返す。
このメソッドはジェネリックではありません。
23.2.3.28 %TypedArray%.prototype.some ( callback [ , thisArg ] )
このメソッドの引数の解釈と利用はArray.prototype.someと同じです。
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) に設定する。 IsCallable (callback) がfalse なら、TypeError 例外を投げる。- k を 0 に設定する。
- k < len の間、繰り返す:
false を返す。
このメソッドはジェネリックではありません。
23.2.3.29 %TypedArray%.prototype.sort ( comparator )
このメソッドは個別のメソッドであり、以下に記載する内容を除き、Array.prototype.sortと同じ要件を実装します。このメソッドの実装は、
このメソッドはジェネリックではありません。
呼び出されたとき、以下の手順を実行します:
- comparator が
undefined でなく、かつIsCallable (comparator) がfalse の場合、TypeError 例外を投げる。 - obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) に設定する。 - 注: 以下のクロージャは、
23.1.3.30 で使われる文字列比較ではなく数値比較を行います。 - SortCompare を、引数 (x, y) を持ち comparator
をキャプチャし、呼び出されたとき以下の手順を実行する新しい
抽象クロージャ とする:- ?
CompareTypedArrayElements (x, y, comparator) を返す。
- ?
- sortedList を ?
SortIndexedProperties (obj, len, SortCompare,read-through-holes ) に設定する。 - j を 0 に設定する。
- j < len の間、繰り返す:
- obj を返す。
23.2.3.30 %TypedArray%.prototype.subarray ( start, end )
このメソッドは、新しいTypedArrayを返します。その要素型はこのTypedArrayの要素型と同じであり、そのArrayBufferはこのTypedArrayのArrayBufferであり、start（含む）からend（含まない）までの
呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[TypedArrayName]]) を実行する。 Assert : O は [[ViewedArrayBuffer]] 内部スロットを持つ。- buffer を O.[[ViewedArrayBuffer]] に設定する。
- srcRecord を
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst ) に設定する。 IsTypedArrayOutOfBounds (srcRecord) がtrue なら、- srcLength を 0 に設定する。
- それ以外の場合、
- srcLength を
TypedArrayLength (srcRecord) に設定する。
- srcLength を
- relativeStart を ?
ToIntegerOrInfinity (start) に設定する。 - relativeStart = -∞ の場合、startIndex を 0 に設定する。
- それ以外で relativeStart < 0 の場合、startIndex を
max (srcLength + relativeStart, 0) に設定する。 - それ以外の場合、startIndex を
min (relativeStart, srcLength) に設定する。 - elementSize を
TypedArrayElementSize (O) に設定する。 - srcByteOffset を O.[[ByteOffset]] に設定する。
- beginByteOffset を srcByteOffset + (startIndex × elementSize) に設定する。
- O.[[ArrayLength]] が
auto かつ end がundefined の場合、- argumentsList を « buffer,
𝔽 (beginByteOffset) » に設定する。
- argumentsList を « buffer,
- それ以外の場合、
- end が
undefined の場合 relativeEnd を srcLength とし、それ以外は relativeEnd を ?ToIntegerOrInfinity (end) に設定する。 - relativeEnd = -∞ の場合、endIndex を 0 に設定する。
- それ以外で relativeEnd < 0 の場合、endIndex を
max (srcLength + relativeEnd, 0) に設定する。 - それ以外の場合、endIndex を
min (relativeEnd, srcLength) に設定する。 - newLength を
max (endIndex - startIndex, 0) に設定する。 - argumentsList を « buffer,
𝔽 (beginByteOffset),𝔽 (newLength) » に設定する。
- end が
- ?
TypedArraySpeciesCreate (O, argumentsList) を返す。
このメソッドはジェネリックではありません。
23.2.3.31 %TypedArray%.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
このメソッドは個別のメソッドであり、Array.prototype.toLocaleStringと同じアルゴリズムを実装しますが、
このメソッドはジェネリックではありません。
ECMAScript実装にECMA-402国際化APIが含まれている場合、このメソッドはECMA-402仕様のArray.prototype.toLocaleStringのアルゴリズムに基づきます。
23.2.3.32 %TypedArray%.prototype.toReversed ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) に設定する。 - length を
TypedArrayLength (taRecord) に設定する。 - A を ?
TypedArrayCreateSameType (O, «𝔽 (length) » ) に設定する。 - k を 0 に設定する。
- k < length の間、繰り返す:
- A を返す。
23.2.3.33 %TypedArray%.prototype.toSorted ( comparator )
このメソッドは呼び出されたとき、以下の手順を実行します:
- comparator が
undefined でなく、かつIsCallable (comparator) がfalse の場合、TypeError 例外を投げる。 - O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) に設定する。 - len を
TypedArrayLength (taRecord) に設定する。 - A を ?
TypedArrayCreateSameType (O, «𝔽 (len) » ) に設定する。 - 注: 以下のクロージャは、
23.1.3.34 で使われる文字列比較ではなく数値比較を行います。 - SortCompare を、引数 (x, y) を持ち comparator
をキャプチャし、呼び出されたとき以下の手順を実行する新しい
抽象クロージャ とする:- ?
CompareTypedArrayElements (x, y, comparator) を返す。
- ?
- sortedList を ?
SortIndexedProperties (O, len, SortCompare,read-through-holes ) に設定する。 - j を 0 に設定する。
- j < len の間、繰り返す:
- A を返す。
23.2.3.34 %TypedArray%.prototype.toString ( )
23.2.3.35 %TypedArray%.prototype.values ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
ValidateTypedArray (O,seq-cst ) を実行する。 CreateArrayIterator (O,value ) を返す。
23.2.3.36 %TypedArray%.prototype.with ( index, value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - taRecord を ?
ValidateTypedArray (O,seq-cst ) に設定する。 - len を
TypedArrayLength (taRecord) に設定する。 - relativeIndex を ?
ToIntegerOrInfinity (index) に設定する。 - relativeIndex ≥ 0 の場合、actualIndex を relativeIndex に設定する。
- それ以外の場合、actualIndex を len + relativeIndex に設定する。
- O.[[ContentType]] が
bigint の場合、numericValue を ?ToBigInt (value) に設定する。 - それ以外の場合、numericValue を ?
ToNumber (value) に設定する。 IsValidIntegerIndex (O,𝔽 (actualIndex)) がfalse の場合、RangeError 例外を投げる。- A を ?
TypedArrayCreateSameType (O, «𝔽 (len) » ) に設定する。 - k を 0 に設定する。
- k < len の間、繰り返す:
- A を返す。
23.2.3.37 %TypedArray%.prototype [ %Symbol.iterator% ] ( )
23.2.3.38 get %TypedArray%.prototype [ %Symbol.toStringTag% ]
.prototype[%Symbol.toStringTag%]は
このプロパティは属性 { [[Enumerable]]:
この関数の
23.2.4 TypedArray オブジェクトの抽象操作
23.2.4.1 TypedArrayCreateFromConstructor ( constructor, argumentList )
抽象操作 TypedArrayCreateFromConstructor は、引数 constructor（
- newTypedArray を ?
Construct (constructor, argumentList) に設定する。 - taRecord を ?
ValidateTypedArray (newTypedArray,seq-cst ) に設定する。 Assert : newTypedArray はTypedArray インスタンスのプロパティ で述べられている全ての内部スロットを持つ。- argumentList の要素数が 1 かつ argumentList[0] が
Number 型の場合、IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外を投げる。- length を
TypedArrayLength (taRecord) に設定する。 - length <
ℝ (argumentList[0]) の場合、TypeError 例外を投げる。
- newTypedArray を返す。
23.2.4.2 TypedArrayCreateSameType ( exemplar, argumentList )
抽象操作 TypedArrayCreateSameType は、引数 exemplar（
- constructor を exemplar.[[TypedArrayName]] に対応する組込みオブジェクト（
表75 参照）に設定する。 - result を ?
TypedArrayCreateFromConstructor (constructor, argumentList) に設定する。 Assert : result.[[ContentType]] は exemplar.[[ContentType]] と一致する。- result を返す。
23.2.4.3 TypedArraySpeciesCreate ( exemplar, argumentList )
抽象操作 TypedArraySpeciesCreate は、引数 exemplar（
- defaultConstructor を exemplar.[[TypedArrayName]] に対応する組込みオブジェクト（
表75 参照）に設定する。 - constructor を ?
SpeciesConstructor (exemplar, defaultConstructor) に設定する。 - result を ?
TypedArrayCreateFromConstructor (constructor, argumentList) に設定する。 - result.[[ContentType]] が
exemplar.[[ContentType]]
と一致しない場合、
TypeError 例外を投げる。 - result を返す。
23.2.4.4 ValidateTypedArray ( O, order )
抽象操作 ValidateTypedArray は、引数 O（
- ?
RequireInternalSlot (O, [[TypedArrayName]]) を実行する。 Assert : O は [[ViewedArrayBuffer]] 内部スロットを持つ。- taRecord を
MakeTypedArrayWithBufferWitnessRecord (O, order) に設定する。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外を投げる。- taRecord を返す。
23.2.4.5 TypedArrayElementSize ( O )
抽象操作 TypedArrayElementSize は引数 O（
- O.[[TypedArrayName]] に対し、
表75 で指定されている Element Size の値を返す。
23.2.4.6 TypedArrayElementType ( O )
抽象操作 TypedArrayElementType は引数 O（
- O.[[TypedArrayName]] に対し、
表75 で指定されている Element Type の値を返す。
23.2.4.7 CompareTypedArrayElements ( x, y, comparator )
抽象操作 CompareTypedArrayElements は引数 x（Number または BigInt）、y（Number または
BigInt）、comparator（
23.2.5 TypedArray コンストラクタ
各 TypedArray
- 以下で説明する構造を持つ組み込みオブジェクトであり、
表75 の TypedArray の代わりにコンストラクタ 名が使われる点だけが異なります。 - 引数の数と型によって動作が異なる関数です。TypedArray の呼び出しの実際の動作は渡された引数の数と種類によって決まります。
- 関数として呼び出すことを意図していないため、そのように呼び出すと例外を投げます。
- クラス定義の
extends節の値として使用可能です。指定された TypedArray の動作を継承するサブクラスコンストラクタ は、TypedArrayコンストラクタ へのsuper呼び出しを含め、サブクラスインスタンスを%TypedArray% .prototype組み込みメソッドをサポートするための内部状態で作成・初期化しなければなりません。
23.2.5.1 TypedArray ( ...args )
各 TypedArray
- NewTarget が
undefined の場合、TypeError 例外を投げる。 - constructorName を
表75 で指定されたこの TypedArrayコンストラクタ の Constructor Name の文字列値に設定する。 - proto を
"%TypedArray.prototype%"に設定する。 - numberOfArgs を args の要素数に設定する。
- numberOfArgs = 0 の場合、
- ?
AllocateTypedArray (constructorName, NewTarget, proto, 0) を返す。
- ?
- それ以外の場合、
- firstArgument を args[0] に設定する。
- firstArgument が
オブジェクト の場合、- O を ?
AllocateTypedArray (constructorName, NewTarget, proto) に設定する。 - firstArgument が [[TypedArrayName]] 内部スロットを持つ場合、
- ?
InitializeTypedArrayFromTypedArray (O, firstArgument) を実行する。
- ?
- それ以外で firstArgument が [[ArrayBufferData]] 内部スロットを持つ場合、
- numberOfArgs > 1 の場合、byteOffset を
args[1] に、そうでない場合 byteOffset を
undefined に設定する。 - numberOfArgs > 2 の場合、length を
args[2] に、そうでない場合 length を
undefined に設定する。 - ?
InitializeTypedArrayFromArrayBuffer (O, firstArgument, byteOffset, length) を実行する。
- numberOfArgs > 1 の場合、byteOffset を
args[1] に、そうでない場合 byteOffset を
- それ以外の場合、
Assert : firstArgument はオブジェクト であり、[[TypedArrayName]] も [[ArrayBufferData]] も持たない。- usingIterator を ?
GetMethod (firstArgument,%Symbol.iterator% ) に設定する。 - usingIterator が
undefined でない場合、- values を ?
IteratorToList (?GetIteratorFromMethod (firstArgument, usingIterator)) に設定する。 - ?
InitializeTypedArrayFromList (O, values) を実行する。
- values を ?
- それ以外の場合、
- 注: firstArgument は
iterable オブジェクト でないため、すでに配列ライクオブジェクト であるとみなします。 - ?
InitializeTypedArrayFromArrayLike (O, firstArgument) を実行する。
- 注: firstArgument は
- O を返す。
- O を ?
- それ以外の場合、
Assert : firstArgument はオブジェクトでない 。- elementLength を ?
ToIndex (firstArgument) に設定する。 - ?
AllocateTypedArray (constructorName, NewTarget, proto, elementLength) を返す。
23.2.5.1.1 AllocateTypedArray ( constructorName, newTarget, defaultProto [ , length ] )
抽象操作 AllocateTypedArray は、引数 constructorName（
- proto を ?
GetPrototypeFromConstructor (newTarget, defaultProto) に設定する。 - obj を
TypedArrayCreate (proto) に設定する。 Assert : obj.[[ViewedArrayBuffer]] はundefined である。- obj.[[TypedArrayName]] を constructorName に設定する。
- constructorName が
"BigInt64Array" または"BigUint64Array" のいずれかの場合、obj.[[ContentType]] をbigint に設定する。 - それ以外の場合、obj.[[ContentType]] を
number に設定する。 - length が存在しない場合、
- obj.[[ByteLength]] を 0 に設定する。
- obj.[[ByteOffset]] を 0 に設定する。
- obj.[[ArrayLength]] を 0 に設定する。
- それ以外の場合、
- ?
AllocateTypedArrayBuffer (obj, length) を実行する。
- ?
- obj を返す。
23.2.5.1.2 InitializeTypedArrayFromTypedArray ( O, srcArray )
抽象操作 InitializeTypedArrayFromTypedArray は、引数 O（
- srcData を srcArray.[[ViewedArrayBuffer]] に設定する。
- elementType を
TypedArrayElementType (O) に設定する。 - elementSize を
TypedArrayElementSize (O) に設定する。 - srcType を
TypedArrayElementType (srcArray) に設定する。 - srcElementSize を
TypedArrayElementSize (srcArray) に設定する。 - srcByteOffset を srcArray.[[ByteOffset]] に設定する。
- srcRecord を
MakeTypedArrayWithBufferWitnessRecord (srcArray,seq-cst ) に設定する。 IsTypedArrayOutOfBounds (srcRecord) がtrue の場合、TypeError 例外を投げる。- elementLength を
TypedArrayLength (srcRecord) に設定する。 - byteLength を elementSize × elementLength に設定する。
- elementType が srcType の場合、
- data を ?
CloneArrayBuffer (srcData, srcByteOffset, byteLength) に設定する。
- data を ?
- それ以外の場合、
- data を ?
AllocateArrayBuffer (%ArrayBuffer% , byteLength) に設定する。 - srcArray.[[ContentType]] が
O.[[ContentType]]
と異なる場合、
TypeError 例外を投げる。 - srcByteIndex を srcByteOffset に設定する。
- targetByteIndex を 0 に設定する。
- count を elementLength に設定する。
- count > 0 の間、繰り返す:
- value を
GetValueFromBuffer (srcData, srcByteIndex, srcType,true ,unordered ) に設定する。 SetValueInBuffer (data, targetByteIndex, elementType, value,true ,unordered ) を実行する。- srcByteIndex を srcByteIndex + srcElementSize に設定する。
- targetByteIndex を targetByteIndex + elementSize に設定する。
- count を count - 1 に設定する。
- value を
- data を ?
- O.[[ViewedArrayBuffer]] を data に設定する。
- O.[[ByteLength]] を byteLength に設定する。
- O.[[ByteOffset]] を 0 に設定する。
- O.[[ArrayLength]] を elementLength に設定する。
unused を返す。
23.2.5.1.3 InitializeTypedArrayFromArrayBuffer ( O, buffer, byteOffset, length )
抽象操作 InitializeTypedArrayFromArrayBuffer は、引数 O（
- elementSize を
TypedArrayElementSize (O) に設定する。 - offset を ?
ToIndex (byteOffset) に設定する。 - offset
modulo elementSize ≠ 0 の場合、RangeError 例外を投げる。 - bufferIsFixedLength を
IsFixedLengthArrayBuffer (buffer) に設定する。 - length が
undefined でない場合、- newLength を ?
ToIndex (length) に設定する。
- newLength を ?
IsDetachedBuffer (buffer) がtrue の場合、TypeError 例外を投げる。- bufferByteLength を
ArrayBufferByteLength (buffer,seq-cst ) に設定する。 - length が
undefined かつ bufferIsFixedLength がfalse の場合、- offset > bufferByteLength
の場合、
RangeError 例外を投げる。 - O.[[ByteLength]] を
auto に設定する。 - O.[[ArrayLength]] を
auto に設定する。
- offset > bufferByteLength
の場合、
- それ以外の場合、
- length が
undefined の場合、- bufferByteLength
modulo elementSize ≠ 0 の場合、RangeError 例外を投げる。 - newByteLength を bufferByteLength - offset に設定する。
- newByteLength < 0
の場合、
RangeError 例外を投げる。
- bufferByteLength
- それ以外の場合、
- newByteLength を newLength × elementSize に設定する。
- offset + newByteLength >
bufferByteLength
の場合、
RangeError 例外を投げる。
- O.[[ByteLength]] を newByteLength に設定する。
- O.[[ArrayLength]] を newByteLength / elementSize に設定する。
- length が
- O.[[ViewedArrayBuffer]] を buffer に設定する。
- O.[[ByteOffset]] を offset に設定する。
unused を返す。
23.2.5.1.4 InitializeTypedArrayFromList ( O, values )
抽象操作 InitializeTypedArrayFromList は、引数 O（
23.2.5.1.5 InitializeTypedArrayFromArrayLike ( O, arrayLike )
抽象操作 InitializeTypedArrayFromArrayLike は、引数 O（
- len を ?
LengthOfArrayLike (arrayLike) に設定する。 - ?
AllocateTypedArrayBuffer (O, len) を実行する。 - k を 0 に設定する。
- k < len の間、繰り返す:
unused を返す。
23.2.5.1.6 AllocateTypedArrayBuffer ( O, length )
抽象操作 AllocateTypedArrayBuffer は、引数 O（
Assert : O.[[ViewedArrayBuffer]] はundefined である。- elementSize を
TypedArrayElementSize (O) に設定する。 - byteLength を elementSize × length に設定する。
- data を ?
AllocateArrayBuffer (%ArrayBuffer% , byteLength) に設定する。 - O.[[ViewedArrayBuffer]] を data に設定する。
- O.[[ByteLength]] を byteLength に設定する。
- O.[[ByteOffset]] を 0 に設定する。
- O.[[ArrayLength]] を length に設定する。
unused を返す。
23.2.6 TypedArray コンストラクタのプロパティ
各 TypedArray
- [[Prototype]] 内部スロットを持ち、その値は
%TypedArray% です。 "length" プロパティを持ち、その値は3 𝔽 です。"name" プロパティを持ち、その値は表75 で指定されたコンストラクタ 名の文字列値です。- 以下のプロパティを持ちます:
23.2.6.1 TypedArray.BYTES_PER_ELEMENT
TypedArray.BYTES_PER_ELEMENT の値は TypedArray に対して
このプロパティは属性 { [[Writable]]:
23.2.6.2 TypedArray.prototype
TypedArray.prototype の初期値は、対応する TypedArray
プロトタイプ組込みオブジェクトです（
このプロパティは属性 { [[Writable]]:
23.2.7 TypedArray プロトタイプオブジェクトのプロパティ
各 TypedArray プロトタイプオブジェクト:
- [[Prototype]] 内部スロットを持ち、その値は
%TypedArray.prototype% です。 通常のオブジェクト です。- [[ViewedArrayBuffer]] や TypedArray インスタンス固有の他の内部スロットは持ちません。
23.2.7.1 TypedArray.prototype.BYTES_PER_ELEMENT
TypedArray.prototype.BYTES_PER_ELEMENT の値は TypedArray に対して
このプロパティは属性 { [[Writable]]:
23.2.7.2 TypedArray.prototype.constructor
特定の TypedArray
23.2.8 TypedArray インスタンスのプロパティ
TypedArray インスタンスは
24 Keyed コレクション
24.1 Map オブジェクト
Mapはキー/値のペアのコレクションであり、キーと値の両方は任意の
Mapは、平均してコレクション内の要素数に対してサブリニアなアクセス時間を提供するハッシュテーブルやその他のメカニズムを用いて実装されなければなりません。この仕様で用いられるデータ構造は、Mapの必要な観測可能な意味論を記述するためだけのものであり、実際の実装モデルとして意図されているものではありません。
24.1.1 Map コンストラクタ
Map
- %Map%である。
グローバルオブジェクト の"Map" プロパティの初期値である。コンストラクタ として呼び出すと、新しいMapを作成・初期化する。- 関数として呼び出すことは意図されておらず、その場合は例外を投げる。
- クラス定義の
extends句の値として使用可能。指定されたMap動作を継承したいサブクラスコンストラクタ は、Mapコンストラクタ へのsuper呼び出しを含め、サブクラスインスタンスにMap.prototype組み込みメソッドをサポートするための内部状態を作成・初期化しなければならない。
24.1.1.1 Map ( [ iterable ] )
この関数は呼び出されたとき、以下の手順を実行します:
- NewTarget が
undefined の場合、TypeError 例外を投げる。 - map を ?
OrdinaryCreateFromConstructor (NewTarget,"%Map.prototype%" , « [[MapData]] » ) に設定する。 - map.[[MapData]] を新しい空の
List に設定する。 - iterableが
undefined またはnull の場合、mapを返す。 - adder を ?
Get (map,"set" ) に設定する。 IsCallable (adder)がfalse の場合、TypeError 例外を投げる。- ?
AddEntriesFromIterable (map, iterable, adder) を返す。
引数iterableが指定された場合、
24.1.1.2 AddEntriesFromIterable ( target, iterable, adder )
抽象操作 AddEntriesFromIterable は、引数target（オブジェクト）、iterable（
- iteratorRecord を ?
GetIterator (iterable,sync ) に設定する。 - 繰り返す:
- next を ?
IteratorStepValue (iteratorRecord) に設定する。 - nextが
done の場合、targetを返す。 - nextが
オブジェクトでない 場合:- error を
ThrowCompletion (新しく作成したTypeError オブジェクト) に設定する。 - ?
IteratorClose (iteratorRecord, error) を返す。
- error を
- k を
Completion (Get (next,"0" )) に設定する。 IfAbruptCloseIterator (k, iteratorRecord) を実行する。- v を
Completion (Get (next,"1" )) に設定する。 IfAbruptCloseIterator (v, iteratorRecord) を実行する。- status を
Completion (Call (adder, target, « k, v »)) に設定する。 IfAbruptCloseIterator (status, iteratorRecord) を実行する。
- next を ?
パラメータiterableは、
24.1.2 Map コンストラクタのプロパティ
Map
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 - 以下のプロパティを持ちます:
24.1.2.1 Map.groupBy ( items, callback )
callbackは2つの引数を受け取る関数であるべきです。
groupByはitems内の各要素について昇順でcallbackを1回呼び出し、新しいMapを構築します。callbackで返された各値はMapのキーとして使われます。そのキーごとに、結果のMapにはそのキーをキーとし、callbackがそのキーを返した全ての要素を含む配列を値とするエントリが作られます。
callbackは要素の値と要素のインデックスの2つの引数で呼び出されます。
groupByの戻り値はMapです。
この関数は呼び出されたとき、以下の手順を実行します:
24.1.2.2 Map.prototype
Map.prototypeの初期値は
このプロパティは属性 { [[Writable]]:
24.1.2.3 get Map [ %Symbol.species% ]
Map[%Symbol.species%]は
this 値を返す。
この関数の
派生コレクションオブジェクトを作成するメソッドは、
24.1.3 Mapプロトタイプオブジェクトのプロパティ
Mapプロトタイプオブジェクト:
- %Map.prototype%である。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% です。 通常のオブジェクト です。- [[MapData]]内部スロットを持ちません。
24.1.3.1 Map.prototype.clear ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- Mを
this 値とする。 - ?
RequireInternalSlot (M, [[MapData]])を実行する。 - M.[[MapData]]の各
Record { [[Key]], [[Value]] } pについて:- p.[[Key]]を
empty に設定する。 - p.[[Value]]を
empty に設定する。
- p.[[Key]]を
undefined を返す。
既存の[[MapData]]
24.1.3.2 Map.prototype.constructor
Map.prototype.constructorの初期値は
24.1.3.3 Map.prototype.delete ( key )
このメソッドは呼び出されたとき、以下の手順を実行します:
- Mを
this 値とする。 - ?
RequireInternalSlot (M, [[MapData]])を実行する。 - keyを
CanonicalizeKeyedCollectionKey (key)に設定する。 - M.[[MapData]]の各
Record { [[Key]], [[Value]] } pについて:- p.[[Key]]が
empty でなく、かつSameValue (p.[[Key]], key)がtrue の場合:- p.[[Key]]を
empty に設定する。 - p.[[Value]]を
empty に設定する。 true を返す。
- p.[[Key]]を
- p.[[Key]]が
false を返す。
24.1.3.4 Map.prototype.entries ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- Mを
this 値とする。 - ?
CreateMapIterator (M,key+value )を返す。
24.1.3.5 Map.prototype.forEach ( callback [ , thisArg ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- Mを
this 値とする。 - ?
RequireInternalSlot (M, [[MapData]])を実行する。 IsCallable (callback)がfalse の場合、TypeError 例外を投げる。- entriesをM.[[MapData]]とする。
- numEntriesをentriesの要素数とする。
- indexを0に設定する。
- index<numEntriesの間、繰り返す:
- eをentries[index]とする。
- indexをindex+1に設定する。
- e.[[Key]]が
empty でない場合:- ?
Call (callback, thisArg, « e.[[Value]], e.[[Key]], M » )を実行する。 - 注: callbackの実行中にentriesの要素数が増加する場合がある。
- numEntriesをentriesの要素数に設定する。
- ?
undefined を返す。
callbackは3つの引数を受け取る関数であるべきです。
forEachはMap内の各キー/値ペアについて、キーの挿入順でcallbackを1回呼び出します。Mapの実際に存在するキーのみが呼び出され、削除されたキーに対しては呼び出されません。
thisArgパラメータが指定された場合、各callback呼び出しの
callbackは、アイテムの値、アイテムのキー、および巡回中のMapの3つの引数で呼び出されます。
forEachは直接オブジェクトを変更しませんが、callbackの呼び出しによってオブジェクトが変更される場合があります。Mapの[[MapData]]の各エントリは1回だけ訪問されます。forEach開始後に追加された新しいキーも訪問されます。訪問後に削除され、forEach完了前に再追加されたキーは再訪問されます。開始後に削除され訪問前のキーは、再追加されない限り訪問されません。
24.1.3.6 Map.prototype.get ( key )
このメソッドは呼び出されたとき、以下の手順を実行します:
- Mを
this 値とする。 - ?
RequireInternalSlot (M, [[MapData]])を実行する。 - keyを
CanonicalizeKeyedCollectionKey (key)に設定する。 - M.[[MapData]]の各
Record { [[Key]], [[Value]] } pについて:- p.[[Key]]が
empty でなく、かつSameValue (p.[[Key]], key)がtrue の場合、p.[[Value]]を返す。
- p.[[Key]]が
undefined を返す。
24.1.3.7 Map.prototype.has ( key )
このメソッドは呼び出されたとき、以下の手順を実行します:
- Mを
this 値とする。 - ?
RequireInternalSlot (M, [[MapData]])を実行する。 - keyを
CanonicalizeKeyedCollectionKey (key)に設定する。 - M.[[MapData]]の各
Record { [[Key]], [[Value]] } pについて:- p.[[Key]]が
empty でなく、かつSameValue (p.[[Key]], key)がtrue の場合、true を返す。
- p.[[Key]]が
false を返す。
24.1.3.8 Map.prototype.keys ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- Mを
this 値とする。 - ?
CreateMapIterator (M,key )を返す。
24.1.3.9 Map.prototype.set ( key, value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- Mを
this 値とする。 - ?
RequireInternalSlot (M, [[MapData]])を実行する。 - keyを
CanonicalizeKeyedCollectionKey (key)に設定する。 - M.[[MapData]]の各
Record { [[Key]], [[Value]] } pについて:- p.[[Key]]が
empty でなく、かつSameValue (p.[[Key]], key)がtrue の場合:- p.[[Value]]をvalueに設定する。
- Mを返す。
- p.[[Key]]が
- pを
Record { [[Key]]: key, [[Value]]: value }に設定する。 - pをM.[[MapData]]に追加する。
- Mを返す。
24.1.3.10 get Map.prototype.size
Map.prototype.sizeは
- Mを
this 値とする。 - ?
RequireInternalSlot (M, [[MapData]])を実行する。 - countを0に設定する。
- M.[[MapData]]の各
Record { [[Key]], [[Value]] } pについて:- p.[[Key]]が
empty でない場合、countをcount+1に設定する。
- p.[[Key]]が
𝔽 (count)を返す。
24.1.3.11 Map.prototype.values ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- Mを
this 値とする。 - ?
CreateMapIterator (M,value )を返す。
24.1.3.12 Map.prototype [ %Symbol.iterator% ] ( )
24.1.3.13 Map.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
24.1.4 Mapインスタンスのプロパティ
Mapインスタンスは
24.1.5 Map イテレータオブジェクト
Map
イテレータは、特定の Map インスタンスオブジェクト上の特定の反復を表すオブジェクトです。Map イテレータオブジェクトには名前付きの
24.1.5.1 CreateMapIterator ( map, kind )
抽象操作 CreateMapIterator は、引数 map（
- ?
RequireInternalSlot (map, [[MapData]]) を実行する。 - closure を、パラメーターなしで map と kind
をキャプチャし、呼び出されたとき以下の手順を実行する新しい
抽象クロージャ とする:- entries を map.[[MapData]] に設定する。
- index を 0 に設定する。
- numEntries を entries の要素数に設定する。
- index < numEntries の間、繰り返す:
- e を entries[index] に設定する。
- index を index + 1 に設定する。
- e.[[Key]] が
empty でない場合、- kind が
key の場合、- result を e.[[Key]] に設定する。
- それ以外で kind が
value の場合、- result を e.[[Value]] に設定する。
- それ以外の場合、
Assert : kind はkey+value である。- result を
CreateArrayFromList (« e.[[Key]], e.[[Value]] ») に設定する。
- ?
GeneratorYield (CreateIteratorResultObject (result,false )) を実行する。 - 注: entries の要素数は、
GeneratorYield によってこの抽象操作の実行が一時停止されている間に増加している場合があります。 - numEntries を entries の要素数に再設定する。
- kind が
NormalCompletion (unused ) を返す。
CreateIteratorFromClosure (closure,"%MapIteratorPrototype%" ,%MapIteratorPrototype% ) を返す。
24.1.5.2 %MapIteratorPrototype% オブジェクト
%MapIteratorPrototype% オブジェクト:
- すべての
Map イテレータオブジェクト が継承するプロパティを持ちます。 通常のオブジェクト です。- [[Prototype]] 内部スロットを持ち、その値は
%Iterator.prototype% です。 - 以下のプロパティを持ちます:
24.1.5.2.1 %MapIteratorPrototype%.next ( )
- ?
GeneratorResume (this 値,empty ,"%MapIteratorPrototype%" ) を返す。
24.1.5.2.2 %MapIteratorPrototype% [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
24.2 Set オブジェクト
Set オブジェクトは
Set オブジェクトは、平均アクセス時間がコレクション内の要素数に対して亜線形となるようなハッシュテーブルまたはその他の機構を使って実装されなければなりません。本仕様で用いられるデータ構造は、Set オブジェクトの必要な観測可能な意味論のみを記述するものであり、実装モデルとして適切であることを意図したものではありません。
24.2.1 Set オブジェクトの抽象操作
24.2.1.1 Set レコード
Set レコードは、Set
または類似オブジェクトのインタフェースをカプセル化するために用いられる
Set レコードは
24.2.1.2 GetSetRecord ( obj )
抽象操作 GetSetRecord は、引数 obj（
- obj が
オブジェクトでない 場合、TypeError 例外を投げる。 - rawSize を ?
Get (obj,"size" ) に設定する。 - numSize を ?
ToNumber (rawSize) に設定する。 - 注: rawSize が
undefined の場合、numSize はNaN となる。 - numSize が
NaN の場合、TypeError 例外を投げる。 - intSize を !
ToIntegerOrInfinity (numSize) に設定する。 - intSize < 0 の場合、
RangeError 例外を投げる。 - has を ?
Get (obj,"has" ) に設定する。 IsCallable (has) がfalse の場合、TypeError 例外を投げる。- keys を ?
Get (obj,"keys" ) に設定する。 IsCallable (keys) がfalse の場合、TypeError 例外を投げる。- 新しい
Set レコード { [[SetObject]]: obj, [[Size]]: intSize, [[Has]]: has, [[Keys]]: keys } を返す。
24.2.1.3 SetDataHas ( setData, value )
抽象操作 SetDataHas は、引数 setData（
SetDataIndex (setData, value) がnot-found の場合、false を返す。true を返す。
24.2.1.4 SetDataIndex ( setData, value )
抽象操作 SetDataIndex は、引数 setData（
- value を
CanonicalizeKeyedCollectionKey (value) に設定する。 - size を setData の要素数に設定する。
- index を 0 に設定する。
- index < size の間、繰り返す:
- e を setData[index] に設定する。
- e が
empty でない、かつ e = value の場合、- index を返す。
- index を index + 1 に設定する。
not-found を返す。
24.2.1.5 SetDataSize ( setData )
抽象操作 SetDataSize は、引数 setData（
- count を 0 に設定する。
- setData の各要素 e について、
- e が
empty でない場合、count を count + 1 に設定する。
- e が
- count を返す。
24.2.2 Set コンストラクタ
Set
- %Set% です。
グローバルオブジェクト の"Set" プロパティの初期値です。コンストラクタ として呼び出された時、新しい Set オブジェクトを生成し初期化します。- 関数として呼び出すことは意図されておらず、その場合は例外を投げます。
- クラス定義の
extends節の値として使うことができます。指定された Set の動作を継承するサブクラスコンストラクタ は、Setコンストラクタ へのsuper呼び出しを含め、サブクラスインスタンスをSet.prototype組み込みメソッドをサポートするための内部状態で作成・初期化しなければなりません。
24.2.2.1 Set ( [ iterable ] )
この関数は呼び出されたとき、以下の手順を実行します:
- NewTarget が
undefined の場合、TypeError 例外を投げる。 - set を ?
OrdinaryCreateFromConstructor (NewTarget,"%Set.prototype%" , « [[SetData]] ») に設定する。 - set.[[SetData]] を新しい空の
List に設定する。 - iterable が
undefined またはnull の場合、set を返す。 - adder を ?
Get (set,"add" ) に設定する。 IsCallable (adder) がfalse の場合、TypeError 例外を投げる。- iteratorRecord を ?
GetIterator (iterable,sync ) に設定する。 - 繰り返す:
- next を ?
IteratorStepValue (iteratorRecord) に設定する。 - next が
done の場合、set を返す。 - status を
Completion (Call (adder, set, « next »)) に設定する。 IfAbruptCloseIterator (status, iteratorRecord) を実行する。
- next を ?
24.2.3 Set コンストラクタのプロパティ
Set
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 - 以下のプロパティを持ちます:
24.2.3.1 Set.prototype
Set.prototype の初期値は
このプロパティは属性 { [[Writable]]:
24.2.3.2 get Set [ %Symbol.species% ]
Set[%Symbol.species%] は
this 値を返す。
この関数の
派生コレクションオブジェクトを生成するメソッドは
24.2.4 Set プロトタイプオブジェクトのプロパティ
Set プロトタイプオブジェクト:
- %Set.prototype% です。
- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。 通常のオブジェクト です。- [[SetData]] 内部スロットは持ちません。
24.2.4.1 Set.prototype.add ( value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- S を
this 値とする。 - ?
RequireInternalSlot (S, [[SetData]]) を実行する。 - value を
CanonicalizeKeyedCollectionKey (value) に設定する。 - S.[[SetData]] の各要素 e について、
- e が
empty でなく、かつSameValue (e, value) がtrue の場合、- S を返す。
- e が
- value を S.[[SetData]] に追加する。
- S を返す。
24.2.4.2 Set.prototype.clear ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- S を
this 値とする。 - ?
RequireInternalSlot (S, [[SetData]]) を実行する。 - S.[[SetData]] の各要素 e について、
- 値が e である S.[[SetData]]
の要素を、値が
empty である要素に置き換える。
- 値が e である S.[[SetData]]
の要素を、値が
undefined を返す。
既存の [[SetData]]
24.2.4.3 Set.prototype.constructor
Set.prototype.constructor の初期値は
24.2.4.4 Set.prototype.delete ( value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- S を
this 値とする。 - ?
RequireInternalSlot (S, [[SetData]]) を実行する。 - value を
CanonicalizeKeyedCollectionKey (value) に設定する。 - S.[[SetData]] の各要素 e について、
- e が
empty でなく、かつSameValue (e, value) がtrue の場合、- 値が e である S.[[SetData]] の要素を、値が
empty である要素に置き換える。 true を返す。
- 値が e である S.[[SetData]] の要素を、値が
- e が
false を返す。
24.2.4.5 Set.prototype.difference ( other )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) に設定する。 - resultSetData を O.[[SetData]] のコピーに設定する。
SetDataSize (O.[[SetData]]) ≤ otherRec.[[Size]] の場合、- それ以外の場合、
- keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) に設定する。 - next を
not-started に設定する。 - next が
done でない間、繰り返す:- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、- next を
CanonicalizeKeyedCollectionKey (next) に設定する。 - valueIndex を
SetDataIndex (resultSetData, next) に設定する。 - valueIndex が
not-found でない場合、- resultSetData[valueIndex] を
empty に設定する。
- resultSetData[valueIndex] を
- next を
- next を ?
- keysIter を ?
- result を
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] ») に設定する。 - result.[[SetData]] を resultSetData に設定する。
- result を返す。
24.2.4.6 Set.prototype.entries ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- S を
this 値とする。 - ?
CreateSetIterator (S,key+value ) を返す。
繰り返しの目的では、Set は各エントリーのキーと値が同じ値になる Map のように見えます。
24.2.4.7 Set.prototype.forEach ( callback [ , thisArg ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- S を
this 値とする。 - ?
RequireInternalSlot (S, [[SetData]]) を実行する。 IsCallable (callback) がfalse の場合、TypeError 例外を投げる。- entries を S.[[SetData]] に設定する。
- numEntries を entries の要素数に設定する。
- index を 0 に設定する。
- index < numEntries の間、繰り返す:
- e を entries[index] に設定する。
- index を index + 1 に設定する。
- e が
empty でない場合、- ?
Call (callback, thisArg, « e, e, S ») を実行する。 - 注: entries の要素数は callback の実行中に増加する場合があります。
- numEntries を entries の要素数に設定し直す。
- ?
undefined を返す。
callback は 3 つの引数を受け取る関数であるべきです。forEach は Set
オブジェクト内に存在する各値ごとに、挿入順で callback を 1 回呼び出します。callback は Set
内に実際に存在する値に対してのみ呼び出されます。削除された値には呼び出されません。
thisArg パラメータが指定された場合、それが callback の呼び出しごとに
callback は 3 つの引数で呼び出されます: 最初の 2 つの引数は Set に含まれる値で、どちらも同じ値です。3 番目の引数は走査されている Set オブジェクトです。
callback が 3 つの引数で呼び出されるのは、Map や Array の forEach
メソッドのコールバック関数と一貫性を持たせるためです。Set では各要素値がキーと値の両方とみなされます。
forEach は呼び出されたオブジェクトを直接変更しませんが、callback
の呼び出しによってオブジェクトが変更される場合があります。
各値は通常 1 回だけ訪問されます。ただし、値が訪問後に削除され、forEach
の実行が完了する前に再追加された場合は再訪問されます。forEach
の呼び出し開始後、訪問前に削除された値は、その値が完了前に再追加されない限り訪問されません。呼び出し開始後に追加された新しい値は訪問されます。
24.2.4.8 Set.prototype.has ( value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- S を
this 値とする。 - ?
RequireInternalSlot (S, [[SetData]]) を実行する。 - value を
CanonicalizeKeyedCollectionKey (value) に設定する。 - S.[[SetData]] の各要素 e について、
- e が
empty でなく、かつSameValue (e, value) がtrue の場合、true を返す。
- e が
false を返す。
24.2.4.9 Set.prototype.intersection ( other )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) に設定する。 - resultSetData を新しい空の
List に設定する。 SetDataSize (O.[[SetData]]) ≤ otherRec.[[Size]] の場合、- thisSize を O.[[SetData]] の要素数に設定する。
- index を 0 に設定する。
- index < thisSize の間、繰り返す:
- e を O.[[SetData]][index] に設定する。
- index を index + 1 に設定する。
- e が
empty でない場合、- inOther を
ToBoolean (?Call (otherRec.[[Has]], otherRec.[[SetObject]], « e »)) に設定する。 - inOther が
true の場合、- 注: 以前の otherRec.[[Has]] の呼び出しで O.[[SetData]] の要素が削除され再追加され、このイテレーション中に同じ要素が2回訪問される可能性があります。
SetDataHas (resultSetData, e) がfalse の場合、- e を resultSetData に追加する。
- 注: O.[[SetData]] の要素数は otherRec.[[Has]] の実行中に増加する場合があります。
- thisSize を O.[[SetData]] の要素数に設定し直す。
- inOther を
- それ以外の場合、
- keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) に設定する。 - next を
not-started に設定する。 - next が
done でない間、繰り返す:- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、- next を
CanonicalizeKeyedCollectionKey (next) に設定する。 - inThis を
SetDataHas (O.[[SetData]], next) に設定する。 - inThis が
true の場合、- 注: other
が任意のオブジェクトであるため、
"keys" イテレータ が同じ値を複数回生成する可能性があります。 SetDataHas (resultSetData, next) がfalse の場合、- next を resultSetData に追加する。
- 注: other
が任意のオブジェクトであるため、
- next を
- next を ?
- keysIter を ?
- result を
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] ») に設定する。 - result.[[SetData]] を resultSetData に設定する。
- result を返す。
24.2.4.10 Set.prototype.isDisjointFrom ( other )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) に設定する。 SetDataSize (O.[[SetData]]) ≤ otherRec.[[Size]] の場合、- thisSize を O.[[SetData]] の要素数に設定する。
- index を 0 に設定する。
- index < thisSize の間、繰り返す:
- それ以外の場合、
- keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) に設定する。 - next を
not-started に設定する。 - next が
done でない間、繰り返す:- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、SetDataHas (O.[[SetData]], next) がtrue の場合、- ?
IteratorClose (keysIter,NormalCompletion (unused )) を実行する。 false を返す。
- ?
- next を ?
- keysIter を ?
true を返す。
24.2.4.11 Set.prototype.isSubsetOf ( other )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) に設定する。 SetDataSize (O.[[SetData]]) > otherRec.[[Size]] の場合、false を返す。- thisSize を O.[[SetData]] の要素数に設定する。
- index を 0 に設定する。
- index < thisSize の間、繰り返す:
true を返す。
24.2.4.12 Set.prototype.isSupersetOf ( other )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) に設定する。 SetDataSize (O.[[SetData]]) < otherRec.[[Size]] の場合、false を返す。- keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) に設定する。 - next を
not-started に設定する。 - next が
done でない間、繰り返す:- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、SetDataHas (O.[[SetData]], next) がfalse の場合、- ?
IteratorClose (keysIter,NormalCompletion (unused )) を実行する。 false を返す。
- ?
- next を ?
true を返す。
24.2.4.13 Set.prototype.keys ( )
繰り返しの目的では、Set は各エントリーのキーと値が同じ値になる Map のように見えます。
24.2.4.14 get Set.prototype.size
Set.prototype.size は
- S を
this 値とする。 - ?
RequireInternalSlot (S, [[SetData]]) を実行する。 - size を
SetDataSize (S.[[SetData]]) に設定する。 𝔽 (size) を返す。
24.2.4.15 Set.prototype.symmetricDifference ( other )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) に設定する。 - keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) に設定する。 - resultSetData を O.[[SetData]] のコピーに設定する。
- next を
not-started に設定する。 - next が
done でない間、繰り返す:- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、- next を
CanonicalizeKeyedCollectionKey (next) に設定する。 - resultIndex を
SetDataIndex (resultSetData, next) に設定する。 - resultIndex が
not-found の場合、alreadyInResult をfalse とし、それ以外の場合はtrue とする。 SetDataHas (O.[[SetData]], next) がtrue の場合、- alreadyInResult が
true の場合、resultSetData[resultIndex] をempty に設定する。
- alreadyInResult が
- それ以外の場合、
- alreadyInResult が
false の場合、next を resultSetData に追加する。
- alreadyInResult が
- next を
- next を ?
- result を
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] ») に設定する。 - result.[[SetData]] を resultSetData に設定する。
- result を返す。
24.2.4.16 Set.prototype.union ( other )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) に設定する。 - keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) に設定する。 - resultSetData を O.[[SetData]] のコピーに設定する。
- next を
not-started に設定する。 - next が
done でない間、繰り返す:- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、- next を
CanonicalizeKeyedCollectionKey (next) に設定する。 SetDataHas (resultSetData, next) がfalse の場合、- next を resultSetData に追加する。
- next を
- next を ?
- result を
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] ») に設定する。 - result.[[SetData]] を resultSetData に設定する。
- result を返す。
24.2.4.17 Set.prototype.values ( )
このメソッドは呼び出されたとき、以下の手順を実行します:
- S を
this 値とする。 - ?
CreateSetIterator (S,value ) を返す。
24.2.4.18 Set.prototype [ %Symbol.iterator% ] ( )
24.2.4.19 Set.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
24.2.5 Set インスタンスのプロパティ
Set インスタンスは
24.2.6 Set イテレータオブジェクト
Set
イテレータは、以下に定義する構造を持つ
24.2.6.1 CreateSetIterator ( set, kind )
抽象操作 CreateSetIterator は、引数 set（
- ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - closure を、パラメータなしで set と kind
をキャプチャし、呼び出されたとき以下の手順を実行する新しい
抽象クロージャ とする:- index を 0 に設定する。
- entries を set.[[SetData]] に設定する。
- numEntries を entries の要素数に設定する。
- index < numEntries の間、繰り返す:
- e を entries[index] に設定する。
- index を index + 1 に設定する。
- e が
empty でない場合、- kind が
key+value の場合、- result を
CreateArrayFromList (« e, e ») に設定する。 - ?
GeneratorYield (CreateIteratorResultObject (result,false )) を実行する。
- result を
- それ以外の場合、
Assert : kind はvalue である。- ?
GeneratorYield (CreateIteratorResultObject (e,false )) を実行する。
- 注: entries の要素数は
GeneratorYield によりこの抽象操作の実行が一時停止されている間に増加する場合があります。 - numEntries を entries の要素数に再設定する。
- kind が
NormalCompletion (unused ) を返す。
CreateIteratorFromClosure (closure,"%SetIteratorPrototype%" ,%SetIteratorPrototype% ) を返す。
24.2.6.2 %SetIteratorPrototype% オブジェクト
%SetIteratorPrototype% オブジェクト:
- すべての
Set イテレータオブジェクト が継承するプロパティを持ちます。 通常のオブジェクト です。- [[Prototype]] 内部スロットを持ち、その値は
%Iterator.prototype% です。 - 以下のプロパティを持ちます:
24.2.6.2.1 %SetIteratorPrototype%.next ( )
- ?
GeneratorResume (this 値,empty ,"%SetIteratorPrototype%" ) を返す。
24.2.6.2.2 %SetIteratorPrototype% [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
24.3 WeakMap オブジェクト
WeakMap は、キーがオブジェクトまたはシンボル、値が任意の
実装は、WeakMap のキー/値ペアがアクセス不能になった時点から WeakMap から除去されるまでの遅延を任意に決定しても構いません。この遅延が ECMAScript プログラムから観測可能であれば、プログラム実行に不確定性をもたらす原因となります。そのため、ECMAScript 実装は WeakMap のキーを観測する手段を、観測者が観測されるキー自体を提示しない限り提供してはなりません。
WeakMap は、平均アクセス時間がコレクション内のキー/値ペア数に対して亜線形となるようなハッシュテーブルまたは他の機構で実装されなければなりません。本仕様のデータ構造は WeakMap の必要な観測可能な意味論のみを記述しており、実装モデルとして適切であることを意図したものではありません。
WeakMap および WeakSet は、オブジェクトやシンボルに動的に状態を関連付ける手段を提供することを意図しており、WeakMap や WeakSet インスタンスが存在しない場合にオブジェクトやシンボルがアクセス不能となり、実装のガベージコレクタによるリソース回収の対象となる場合でもメモリリソースが「リーク」しないように設計されています。この特性は、WeakMap や WeakSet インスタンスとキーとの逆方向のオブジェクト/シンボルごとのマッピングを用いることで達成できます。あるいは、各 WeakMap や WeakSet インスタンスが内部的にキーと値のデータを格納する方法もありますが、この場合は WeakMap や WeakSet の実装とガベージコレクタの協調が必要となります。以下の参考文献は、WeakMap と WeakSet の実装に有用となり得る仕組みを説明しています：
Barry Hayes. 1997. Ephemerons: a new finalization mechanism. In Proceedings of the 12th ACM SIGPLAN conference on Object-oriented programming, systems, languages, and applications (OOPSLA '97), A. Michael Berman (Ed.). ACM, New York, NY, USA, 176-183, http://doi.acm.org/10.1145/263698.263733.
Alexandra Barros, Roberto Ierusalimschy, Eliminating Cycles in Weak Tables. Journal of Universal Computer Science - J.UCS, vol. 14, no. 21, pp. 3481-3497, 2008, http://www.jucs.org/jucs_14_21/eliminating_cycles_in_weak
24.3.1 WeakMap コンストラクタ
WeakMap
- %WeakMap% です。
グローバルオブジェクト の"WeakMap" プロパティの初期値です。コンストラクタ として呼び出された時、新しい WeakMap を生成し初期化します。- 関数として呼び出すことは意図されておらず、その場合は例外を投げます。
- クラス定義の
extends節の値として使うことができます。指定された WeakMap の動作を継承するサブクラスコンストラクタ は、WeakMapコンストラクタ へのsuper呼び出しを含め、サブクラスインスタンスをWeakMap.prototype組み込みメソッドをサポートするための内部状態で作成・初期化しなければなりません。
24.3.1.1 WeakMap ( [ iterable ] )
この関数は呼び出されたとき、以下の手順を実行します:
- NewTarget が
undefined の場合、TypeError 例外を投げる。 - map を ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakMap.prototype%" , « [[WeakMapData]] ») に設定する。 - map.[[WeakMapData]] を新しい空の
List に設定する。 - iterable が
undefined またはnull の場合、map を返す。 - adder を ?
Get (map,"set" ) に設定する。 IsCallable (adder) がfalse の場合、TypeError 例外を投げる。- ?
AddEntriesFromIterable (map, iterable, adder) を返す。
パラメータ iterable が存在する場合、それは
24.3.2 WeakMap コンストラクタのプロパティ
WeakMap
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 - 以下のプロパティを持ちます:
24.3.2.1 WeakMap.prototype
WeakMap.prototype の初期値は
このプロパティは属性 { [[Writable]]:
24.3.3 WeakMap プロトタイプオブジェクトのプロパティ
WeakMap プロトタイプオブジェクト:
- %WeakMap.prototype% です。
- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。 通常のオブジェクト です。- [[WeakMapData]] 内部スロットは持ちません。
24.3.3.1 WeakMap.prototype.constructor
WeakMap.prototype.constructor の初期値は
24.3.3.2 WeakMap.prototype.delete ( key )
このメソッドは呼び出されたとき、以下の手順を実行します:
- M を
this 値とする。 - ?
RequireInternalSlot (M, [[WeakMapData]]) を実行する。 CanBeHeldWeakly (key) がfalse の場合、false を返す。- M.[[WeakMapData]] の各
Record { [[Key]], [[Value]] } p について:- p.[[Key]] が
empty でなく、かつSameValue (p.[[Key]], key) がtrue の場合、- p.[[Key]] を
empty に設定する。 - p.[[Value]] を
empty に設定する。 true を返す。
- p.[[Key]] を
- p.[[Key]] が
false を返す。
24.3.3.3 WeakMap.prototype.get ( key )
このメソッドは呼び出されたとき、以下の手順を実行します:
- M を
this 値とする。 - ?
RequireInternalSlot (M, [[WeakMapData]]) を実行する。 CanBeHeldWeakly (key) がfalse の場合、undefined を返す。- M.[[WeakMapData]] の各
Record { [[Key]], [[Value]] } p について:- p.[[Key]] が
empty でなく、かつSameValue (p.[[Key]], key) がtrue の場合、p.[[Value]] を返す。
- p.[[Key]] が
undefined を返す。
24.3.3.4 WeakMap.prototype.has ( key )
このメソッドは呼び出されたとき、以下の手順を実行します:
- M を
this 値とする。 - ?
RequireInternalSlot (M, [[WeakMapData]]) を実行する。 CanBeHeldWeakly (key) がfalse の場合、false を返す。- M.[[WeakMapData]] の各
Record { [[Key]], [[Value]] } p について:- p.[[Key]] が
empty でなく、かつSameValue (p.[[Key]], key) がtrue の場合、true を返す。
- p.[[Key]] が
false を返す。
24.3.3.5 WeakMap.prototype.set ( key, value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- M を
this 値とする。 - ?
RequireInternalSlot (M, [[WeakMapData]]) を実行する。 CanBeHeldWeakly (key) がfalse の場合、TypeError 例外を投げる。- M.[[WeakMapData]] の各
Record { [[Key]], [[Value]] } p について:- p.[[Key]] が
empty でなく、かつSameValue (p.[[Key]], key) がtrue の場合、- p.[[Value]] を value に設定する。
- M を返す。
- p.[[Key]] が
- p を
Record { [[Key]]: key, [[Value]]: value } に設定する。 - p を M.[[WeakMapData]] に追加する。
- M を返す。
24.3.3.6 WeakMap.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
24.3.4 WeakMap インスタンスのプロパティ
WeakMap インスタンスは
24.4 WeakSet オブジェクト
WeakSet はオブジェクトやシンボルのコレクションです。WeakSet のコレクションには、個々のオブジェクトまたはシンボルは一度だけ要素として現れます。WeakSet
は特定の値を含むかどうかを問い合わせることができますが、保持している値を列挙する仕組みは提供されません。特定の条件下では、
実装は、WeakSet に含まれる値がアクセス不能になった時点から WeakSet から除去されるまでの遅延を任意に決定しても構いません。この遅延が ECMAScript プログラムから観測可能であれば、プログラム実行に不確定性をもたらす原因となります。そのため、ECMAScript 実装は WeakSet が特定の値を含むかどうかを、観測者が観測される値自体を提示しない限り判定する手段を提供してはなりません。
WeakSet は、平均アクセス時間がコレクション内の要素数に対して亜線形となるようなハッシュテーブルまたは他の機構で実装されなければなりません。本仕様のデータ構造は WeakSet の必要な観測可能な意味論のみを記述しており、実装モデルとして適切であることを意図したものではありません。
24.4.1 WeakSet コンストラクタ
WeakSet
- %WeakSet% です。
グローバルオブジェクト の"WeakSet" プロパティの初期値です。コンストラクタ として呼び出された時、新しい WeakSet を生成し初期化します。- 関数として呼び出すことは意図されておらず、その場合は例外を投げます。
- クラス定義の
extends節の値として使うことができます。指定された WeakSet の動作を継承するサブクラスコンストラクタ は、WeakSetコンストラクタ へのsuper呼び出しを含め、サブクラスインスタンスをWeakSet.prototype組み込みメソッドをサポートするための内部状態で作成・初期化しなければなりません。
24.4.1.1 WeakSet ( [ iterable ] )
この関数は呼び出されたとき、以下の手順を実行します:
- NewTarget が
undefined の場合、TypeError 例外を投げる。 - set を ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakSet.prototype%" , « [[WeakSetData]] ») に設定する。 - set.[[WeakSetData]] を新しい空の
List に設定する。 - iterable が
undefined またはnull の場合、set を返す。 - adder を ?
Get (set,"add" ) に設定する。 IsCallable (adder) がfalse の場合、TypeError 例外を投げる。- iteratorRecord を ?
GetIterator (iterable,sync ) に設定する。 - 繰り返す:
- next を ?
IteratorStepValue (iteratorRecord) に設定する。 - next が
done の場合、set を返す。 - status を
Completion (Call (adder, set, « next »)) に設定する。 IfAbruptCloseIterator (status, iteratorRecord) を実行する。
- next を ?
24.4.2 WeakSet コンストラクタのプロパティ
WeakSet
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 - 以下のプロパティを持ちます:
24.4.2.1 WeakSet.prototype
WeakSet.prototype の初期値は
このプロパティは属性 { [[Writable]]:
24.4.3 WeakSet プロトタイプオブジェクトのプロパティ
WeakSet プロトタイプオブジェクト:
- %WeakSet.prototype% です。
- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。 通常のオブジェクト です。- [[WeakSetData]] 内部スロットは持ちません。
24.4.3.1 WeakSet.prototype.add ( value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- S を
this 値とする。 - ?
RequireInternalSlot (S, [[WeakSetData]]) を実行する。 CanBeHeldWeakly (value) がfalse の場合、TypeError 例外を投げる。- S.[[WeakSetData]] の各要素 e について:
- e が
empty でなく、かつSameValue (e, value) がtrue の場合:- S を返す。
- e が
- value を S.[[WeakSetData]] に追加する。
- S を返す。
24.4.3.2 WeakSet.prototype.constructor
WeakSet.prototype.constructor の初期値は
24.4.3.3 WeakSet.prototype.delete ( value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- S を
this 値とする。 - ?
RequireInternalSlot (S, [[WeakSetData]]) を実行する。 CanBeHeldWeakly (value) がfalse の場合、false を返す。- S.[[WeakSetData]] の各要素 e について:
- e が
empty でなく、かつSameValue (e, value) がtrue の場合:- 値が e である S.[[WeakSetData]] の要素を、値が
empty である要素に置き換える。 true を返す。
- 値が e である S.[[WeakSetData]] の要素を、値が
- e が
false を返す。
24.4.3.4 WeakSet.prototype.has ( value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- S を
this 値とする。 - ?
RequireInternalSlot (S, [[WeakSetData]]) を実行する。 CanBeHeldWeakly (value) がfalse の場合、false を返す。- S.[[WeakSetData]] の各要素 e について:
- e が
empty でなく、かつSameValue (e, value) がtrue の場合、true を返す。
- e が
false を返す。
24.4.3.5 WeakSet.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
24.4.4 WeakSet インスタンスのプロパティ
WeakSet インスタンスは
24.5 キー付きコレクションのための抽象操作
24.5.1 CanonicalizeKeyedCollectionKey ( key )
抽象操作 CanonicalizeKeyedCollectionKey は引数 key（
- key が
-0 𝔽 の場合、+0 𝔽 を返す。 - key を返す。
25 構造化データ
25.1 ArrayBuffer オブジェクト
25.1.1 記法
このセクション、
read-modify-write
修正関数は、2つの
- アルゴリズムのすべてのステップをアトミックに実行します。
- 個々のアルゴリズムステップは観測できません。
read-modify-write 修正関数のアルゴリズムステップが純粋な数学的関数であることを検証するために、次の編集上の慣例を推奨します:
- 呼び出された
抽象操作 および抽象クロージャを経由しても、直接または間接的に、パラメータやキャプチャされた値以外の言語値や仕様値にアクセスしません。 - 直接または間接的に、
抽象操作 や抽象クロージャを呼び出し、それがCompletion Record を返すことはありません。 Completion Record を返しません。
25.1.2 固定長および可変長 ArrayBuffer オブジェクト
固定長 ArrayBufferは、生成後にバイト長が変更できない ArrayBuffer です。
可変長 ArrayBufferは、
生成される ArrayBuffer オブジェクトの種類は、
25.1.3 ArrayBuffer オブジェクトのための抽象操作
25.1.3.1 AllocateArrayBuffer ( constructor, byteLength [ , maxByteLength ] )
抽象操作 AllocateArrayBuffer は、constructor（
- slots を « [[ArrayBufferData]], [[ArrayBufferByteLength]], [[ArrayBufferDetachKey]] » に設定する。
- maxByteLength が存在し、maxByteLength が
empty でない場合、allocatingResizableBuffer をtrue に、そうでなければfalse に設定する。 - allocatingResizableBuffer が
true の場合:- byteLength > maxByteLength
の場合、
RangeError 例外を投げる。 - [[ArrayBufferMaxByteLength]] を slots に追加する。
- byteLength > maxByteLength
の場合、
- obj を ?
OrdinaryCreateFromConstructor (constructor,"%ArrayBuffer.prototype%" , slots) に設定する。 - block を ?
CreateByteDataBlock (byteLength) に設定する。 - obj.[[ArrayBufferData]] を block に設定する。
- obj.[[ArrayBufferByteLength]] を byteLength に設定する。
- allocatingResizableBuffer が
true の場合:- maxByteLength バイトで構成される
Data Block blockを作成できない場合、RangeError 例外を投げる。 - 注: 可変長 ArrayBuffer はインプレースの拡張で実装可能となるよう設計されています。実装によっては、例えば仮想メモリの事前予約ができない場合、例外を投げることがあります。
- obj.[[ArrayBufferMaxByteLength]] を maxByteLength に設定する。
- maxByteLength バイトで構成される
- obj を返す。
25.1.3.2 ArrayBufferByteLength ( arrayBuffer, order )
抽象操作 ArrayBufferByteLength は、arrayBuffer（ArrayBuffer または SharedArrayBuffer）と
order（
IsSharedArrayBuffer (arrayBuffer) がtrue かつ arrayBuffer が [[ArrayBufferByteLengthData]] 内部スロットを持つ場合:- bufferByteLengthBlock を arrayBuffer.[[ArrayBufferByteLengthData]] に設定する。
- rawLength を
GetRawBytesFromSharedBlock (bufferByteLengthBlock, 0,biguint64 ,true , order) に設定する。 - isLittleEndian を
周囲のエージェント のエージェントレコード の [[LittleEndian]] フィールドの値に設定する。 ℝ (RawBytesToNumeric (biguint64 , rawLength, isLittleEndian)) を返す。
アサート :IsDetachedBuffer (arrayBuffer) がfalse である。 - arrayBuffer.[[ArrayBufferByteLength]] を返す。
25.1.3.3 ArrayBufferCopyAndDetach ( arrayBuffer, newLength, preserveResizability )
抽象操作 ArrayBufferCopyAndDetach は、引数 arrayBuffer（
- ?
RequireInternalSlot (arrayBuffer, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (arrayBuffer) がtrue の場合、TypeError 例外を投げる。- newLength が
undefined の場合:- newByteLength を arrayBuffer.[[ArrayBufferByteLength]] に設定する。
- それ以外の場合:
- newByteLength を ?
ToIndex (newLength) に設定する。
- newByteLength を ?
IsDetachedBuffer (arrayBuffer) がtrue の場合、TypeError 例外を投げる。- preserveResizability が
preserve-resizability で、IsFixedLengthArrayBuffer (arrayBuffer) がfalse の場合:- newMaxByteLength を arrayBuffer.[[ArrayBufferMaxByteLength]] に設定する。
- それ以外の場合:
- newMaxByteLength を
empty に設定する。
- newMaxByteLength を
- arrayBuffer.[[ArrayBufferDetachKey]] が
undefined でない場合、TypeError 例外を投げる。 - newBuffer を ?
AllocateArrayBuffer (%ArrayBuffer% , newByteLength, newMaxByteLength) に設定する。 - copyLength を
min (newByteLength, arrayBuffer.[[ArrayBufferByteLength]]) に設定する。 - fromBlock を arrayBuffer.[[ArrayBufferData]] に設定する。
- toBlock を newBuffer.[[ArrayBufferData]] に設定する。
CopyDataBlockBytes (toBlock, 0, fromBlock, 0, copyLength) を実行する。- 注: 新しい
Data Block の生成や古いData Block からのコピーは観測できません。実装はこのメソッドをゼロコピーのムーブやreallocとして実装してもよいです。 - !
DetachArrayBuffer (arrayBuffer) を実行する。 - newBuffer を返す。
25.1.3.4 IsDetachedBuffer ( arrayBuffer )
抽象操作 IsDetachedBuffer は、引数 arrayBuffer（ArrayBuffer または SharedArrayBuffer）を取り、Boolean を返します。呼び出されたとき、以下の手順を実行します:
- arrayBuffer.[[ArrayBufferData]] が
null の場合、true を返す。 false を返す。
25.1.3.5 DetachArrayBuffer ( arrayBuffer [ , key ] )
抽象操作 DetachArrayBuffer は、引数 arrayBuffer（ArrayBuffer）とオプションの
key（任意の値）を取り、
アサート :IsSharedArrayBuffer (arrayBuffer) がfalse であること。- key が存在しない場合、key を
undefined に設定する。 - arrayBuffer.[[ArrayBufferDetachKey]] が
key でない場合、
TypeError 例外を投げる。 - arrayBuffer.[[ArrayBufferData]] を
null に設定する。 - arrayBuffer.[[ArrayBufferByteLength]] を 0 に設定する。
unused を返す。
ArrayBuffer インスタンスをデタッチすることで、そのインスタンスのバックストアとして使われている
25.1.3.6 CloneArrayBuffer ( srcBuffer, srcByteOffset, srcLength )
抽象操作 CloneArrayBuffer は、引数 srcBuffer（ArrayBuffer または
SharedArrayBuffer）、srcByteOffset（非負
アサート :IsDetachedBuffer (srcBuffer) がfalse であること。- targetBuffer を ?
AllocateArrayBuffer (%ArrayBuffer% , srcLength) に設定する。 - srcBlock を srcBuffer.[[ArrayBufferData]] に設定する。
- targetBlock を targetBuffer.[[ArrayBufferData]] に設定する。
CopyDataBlockBytes (targetBlock, 0, srcBlock, srcByteOffset, srcLength) を実行する。- targetBuffer を返す。
25.1.3.7 GetArrayBufferMaxByteLengthOption ( options )
抽象操作 GetArrayBufferMaxByteLengthOption は、引数 options（
- optionsが
オブジェクトでない場合 、empty を返す。 - maxByteLength を ?
Get (options,"maxByteLength" ) に設定する。 - maxByteLength が
undefined の場合、empty を返す。 - ?
ToIndex (maxByteLength) を返す。
25.1.3.8 HostResizeArrayBuffer ( buffer, newByteLength )
HostResizeArrayBuffer の実装は以下の要件に従う必要があります:
- この抽象操作は buffer を切り離しません。
- 正常に
handled で完了した場合、buffer.[[ArrayBufferByteLength]] は newByteLength になります。
HostResizeArrayBuffer のデフォルト実装は、
25.1.3.9 IsFixedLengthArrayBuffer ( arrayBuffer )
抽象操作 IsFixedLengthArrayBuffer は、引数 arrayBuffer（ArrayBuffer または SharedArrayBuffer）を取り、Boolean を返します。呼び出されたとき、以下の手順を実行します:
- arrayBuffer が [[ArrayBufferMaxByteLength]]
内部スロットを持つ場合、
false を返す。 true を返す。
25.1.3.10 IsUnsignedElementType ( type )
抽象操作 IsUnsignedElementType は、引数 type（
- type が
uint8 ,uint8clamped ,uint16 ,uint32 ,biguint64 のいずれかであればtrue を返す。 false を返す。
25.1.3.11 IsUnclampedIntegerElementType ( type )
抽象操作 IsUnclampedIntegerElementType は、引数 type（
- type が
int8 ,uint8 ,int16 ,uint16 ,int32 ,uint32 のいずれかであればtrue を返す。 false を返す。
25.1.3.12 IsBigIntElementType ( type )
抽象操作 IsBigIntElementType は、引数 type（
- type が
biguint64 またはbigint64 であればtrue を返す。 false を返す。
25.1.3.13 IsNoTearConfiguration ( type, order )
抽象操作 IsNoTearConfiguration は、引数 type（
IsUnclampedIntegerElementType (type) がtrue の場合、true を返す。IsBigIntElementType (type) がtrue かつ order がinit でもunordered でもない場合、true を返す。false を返す。
25.1.3.14 RawBytesToNumeric ( type, rawBytes, isLittleEndian )
抽象操作 RawBytesToNumeric は、引数 type（
- elementSize を
表75 の type の Element Size 値に設定する。 - isLittleEndian が
false の場合、rawBytes の要素の順序を逆にする。 - type が
float16 の場合:- value を rawBytes のバイト要素を連結し、リトルエンディアンビット列として
IEEE 754-2019 binary16 値として解釈したものとする。 - value が NaN であれば
NaN を返す。 - value に対応する Number 値を返す。
- value を rawBytes のバイト要素を連結し、リトルエンディアンビット列として
- type が
float32 の場合:- value を rawBytes のバイト要素を連結し、リトルエンディアンビット列として
IEEE 754-2019 binary32 値として解釈したものとする。 - value が NaN であれば
NaN を返す。 - value に対応する Number 値を返す。
- value を rawBytes のバイト要素を連結し、リトルエンディアンビット列として
- type が
float64 の場合:- value を rawBytes のバイト要素を連結し、リトルエンディアンビット列として
IEEE 754-2019 binary64 値として解釈したものとする。 - value が NaN であれば
NaN を返す。 - value に対応する Number 値を返す。
- value を rawBytes のバイト要素を連結し、リトルエンディアンビット列として
IsUnsignedElementType (type) がtrue の場合:- intValue を rawBytes のバイト要素を連結し、符号なしリトルエンディアンバイナリ数のビット列として解釈したものとする。
- それ以外の場合:
- intValue を rawBytes のバイト要素を連結し、ビット長 elementSize × 8 の2の補数リトルエンディアンバイナリ数のビット列として解釈したものとする。
IsBigIntElementType (type) がtrue の場合、intValue に対応する BigInt 値を返す。- それ以外の場合、intValue に対応する Number 値を返す。
25.1.3.15 GetRawBytesFromSharedBlock ( block, byteIndex, type, isTypedArray, order )
抽象操作 GetRawBytesFromSharedBlock は、引数 block（
- elementSize を
表75 の type の Element Size 値に設定する。 - execution を
周囲のエージェント のエージェントレコード の [[CandidateExecution]] フィールドに設定する。 - eventsRecord を execution.[[EventsRecords]] のうち、[[AgentSignifier]] が
AgentSignifier () であるエージェントイベントレコード に設定する。 - isTypedArray が
true かつIsNoTearConfiguration (type, order) がtrue の場合、noTear をtrue に、そうでなければfalse に設定する。 - rawValue を長さ elementSize の
List 型で、要素は非決定的に選ばれたバイト値 とする。 - 注: 実装では、rawValue は基盤となるハードウェア上の非アトミックまたはアトミックな読み取り命令の結果です。非決定性は
メモリモデル の意味論的規定であり、弱整合性のハードウェアの観測可能な振る舞いを記述します。 - readEvent を
ReadSharedMemory { [[Order]]: order, [[NoTear]]: noTear, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize } に設定する。 - readEvent を eventsRecord.[[EventList]] に追加する。
Chosen Value Record { [[Event]]: readEvent, [[ChosenValue]]: rawValue } を execution.[[ChosenValues]] に追加する。- rawValue を返す。
25.1.3.16 GetValueFromBuffer ( arrayBuffer, byteIndex, type, isTypedArray, order [ , isLittleEndian ] )
抽象操作 GetValueFromBuffer は、引数 arrayBuffer（ArrayBuffer または
SharedArrayBuffer）、byteIndex（非負
アサート :IsDetachedBuffer (arrayBuffer) がfalse であること。アサート : arrayBuffer の byteIndex から始まるバイト数が type の値を表現するのに十分であること。- block を arrayBuffer.[[ArrayBufferData]] に設定する。
- elementSize を
表75 の type の Element Size 値に設定する。 IsSharedArrayBuffer (arrayBuffer) がtrue の場合:アサート : block は共有データブロック であること。- rawValue を
GetRawBytesFromSharedBlock (block, byteIndex, type, isTypedArray, order) に設定する。
- それ以外の場合:
- rawValue を
List 型で、要素は block の byteIndex（含む）から byteIndex + elementSize（含まない）までのインデックスのバイト値とする。
- rawValue を
アサート : rawValue の要素数が elementSize であること。- isLittleEndian が指定されていない場合、isLittleEndian を
周囲のエージェント のエージェントレコード の [[LittleEndian]] フィールド値に設定する。 RawBytesToNumeric (type, rawValue, isLittleEndian) を返す。
25.1.3.17 NumericToRawBytes ( type, value, isLittleEndian )
抽象操作 NumericToRawBytes は、引数 type（
- type が
float16 の場合:- rawBytes を
List 型で、要素は value をIEEE 754-2019 binary16 フォーマット（roundTiesToEven モード）に変換した結果の2バイト。バイトはリトルエンディアン順。value がNaN の場合、rawBytes は実装が選択したIEEE 754-2019 binary16 NaN符号化に設定してよい。実装は区別可能なNaN 値ごとに常に同じ符号化を選ばなければならない。
- rawBytes を
- それ以外で type が
float32 の場合:- rawBytes を
List 型で、要素は value をIEEE 754-2019 binary32 フォーマット（roundTiesToEven モード）に変換した結果の4バイト。バイトはリトルエンディアン順。value がNaN の場合、rawBytes は実装が選択したIEEE 754-2019 binary32 NaN符号化に設定してよい。実装は区別可能なNaN 値ごとに常に同じ符号化を選ばなければならない。
- rawBytes を
- それ以外で type が
float64 の場合:- rawBytes を
List 型で、要素はIEEE 754-2019 binary64 フォーマットで value を符号化した8バイト。バイトはリトルエンディアン順。value がNaN の場合、rawBytes は実装が選択したIEEE 754-2019 binary64 NaN符号化に設定してよい。実装は区別可能なNaN 値ごとに常に同じ符号化を選ばなければならない。
- rawBytes を
- それ以外の場合:
- n を
表75 の type の Element Size 値に設定する。 - conversionOperation を
表75 の type の Conversion Operation 列に記載の抽象操作名に設定する。 - intValue を
ℝ (!conversionOperation(value)) に設定する。 - intValue ≥ 0 の場合:
- rawBytes を
List 型で、要素は intValue の n バイトバイナリ符号化。バイトはリトルエンディアン順とする。
- rawBytes を
- それ以外の場合:
- rawBytes を
List 型で、要素は intValue の n バイト2の補数バイナリ符号化。バイトはリトルエンディアン順とする。
- rawBytes を
- n を
- isLittleEndian が
false の場合、rawBytes の要素の順序を逆にする。 - rawBytes を返す。
25.1.3.18 SetValueInBuffer ( arrayBuffer, byteIndex, type, value, isTypedArray, order [ , isLittleEndian ] )
抽象操作 SetValueInBuffer は、引数 arrayBuffer（ArrayBuffer または
SharedArrayBuffer）、byteIndex（非負
アサート :IsDetachedBuffer (arrayBuffer) がfalse であること。アサート : arrayBuffer の byteIndex から始まるバイト数が type の値を表現するのに十分であること。アサート : type に対してIsBigIntElementType (type) がtrue なら value はBigInt 、それ以外なら value はNumber であること。- block を arrayBuffer.[[ArrayBufferData]] に設定する。
- elementSize を
表75 の type の Element Size 値に設定する。 - isLittleEndian が指定されていない場合、isLittleEndian を
周囲のエージェント のエージェントレコード の [[LittleEndian]] フィールド値に設定する。 - rawBytes を
NumericToRawBytes (type, value, isLittleEndian) に設定する。 IsSharedArrayBuffer (arrayBuffer) がtrue の場合:- execution を
周囲のエージェント のエージェントレコード の [[CandidateExecution]] フィールドに設定する。 - eventsRecord を execution.[[EventsRecords]] のうち、[[AgentSignifier]] が
AgentSignifier () であるエージェントイベントレコード に設定する。 - isTypedArray が
true かつIsNoTearConfiguration (type, order) がtrue の場合、noTear をtrue に、そうでなければfalse に設定する。 WriteSharedMemory { [[Order]]: order, [[NoTear]]: noTear, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize, [[Payload]]: rawBytes } を eventsRecord.[[EventList]] に追加する。
- execution を
- それ以外の場合:
- rawBytes の個々のバイトを block の block[byteIndex] から順に格納する。
unused を返す。
25.1.3.19 GetModifySetValueInBuffer ( arrayBuffer, byteIndex, type, value, op )
抽象操作 GetModifySetValueInBuffer は、引数 arrayBuffer（ArrayBuffer または
SharedArrayBuffer）、byteIndex（非負
アサート :IsDetachedBuffer (arrayBuffer) がfalse であること。アサート : arrayBuffer の byteIndex から始まるバイト数が type の値を表現するのに十分であること。アサート : type に対してIsBigIntElementType (type) がtrue なら value はBigInt 、それ以外なら value はNumber であること。- block を arrayBuffer.[[ArrayBufferData]] に設定する。
- elementSize を
表75 の type の Element Size 値に設定する。 - isLittleEndian を
周囲のエージェント のエージェントレコード の [[LittleEndian]] フィールド値に設定する。 - rawBytes を
NumericToRawBytes (type, value, isLittleEndian) に設定する。 IsSharedArrayBuffer (arrayBuffer) がtrue の場合:- execution を
周囲のエージェント のエージェントレコード の [[CandidateExecution]] フィールドに設定する。 - eventsRecord を execution.[[EventsRecords]] のうち、[[AgentSignifier]] が
AgentSignifier () であるエージェントイベントレコード に設定する。 - rawBytesRead を長さ elementSize の
List 型で、要素は非決定的に選ばれたバイト値 とする。 - 注: 実装では rawBytesRead
はロードリンクやロード排他、または基盤となるハードウェア上のread-modify-write命令のオペランドの結果です。非決定性は
メモリモデル の意味論的規定であり、弱整合性のハードウェアの観測可能な振る舞いを記述します。 - rmwEvent を
ReadModifyWriteSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize, [[Payload]]: rawBytes, [[ModifyOp]]: op } に設定する。 - rmwEvent を eventsRecord.[[EventList]] に追加する。
Chosen Value Record { [[Event]]: rmwEvent, [[ChosenValue]]: rawBytesRead } を execution.[[ChosenValues]] に追加する。
- execution を
- それ以外の場合:
- rawBytesRead を長さ elementSize の
List 型で、要素は block[byteIndex] から始まる elementSize バイトの列とする。 - rawBytesModified を op(rawBytesRead, rawBytes) に設定する。
- rawBytesModified の個々のバイトを block の block[byteIndex] から順に格納する。
- rawBytesRead を長さ elementSize の
RawBytesToNumeric (type, rawBytesRead, isLittleEndian) を返す。
25.1.4 ArrayBuffer コンストラクタ
ArrayBuffer
- %ArrayBuffer% です。
グローバルオブジェクト の"ArrayBuffer" プロパティの初期値です。コンストラクタ として呼び出された時、新しい ArrayBuffer を生成し初期化します。- 関数として呼び出すことは意図されておらず、その場合は例外を投げます。
- クラス定義の
extends節の値として使うことができます。指定された ArrayBuffer の動作を継承するサブクラスコンストラクタ は、ArrayBufferコンストラクタ へのsuper呼び出しを含め、サブクラスインスタンスをArrayBuffer.prototype組み込みメソッドをサポートするための内部状態で作成・初期化しなければなりません。
25.1.4.1 ArrayBuffer ( length [ , options ] )
この関数は呼び出されたとき、以下の手順を実行します:
- NewTarget が
undefined の場合、TypeError 例外を投げる。 - byteLength を ?
ToIndex (length) に設定する。 - requestedMaxByteLength を ?
GetArrayBufferMaxByteLengthOption (options) に設定する。 - ?
AllocateArrayBuffer (NewTarget, byteLength, requestedMaxByteLength) を返す。
25.1.5 ArrayBuffer コンストラクタのプロパティ
ArrayBuffer
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 - 以下のプロパティを持ちます:
25.1.5.1 ArrayBuffer.isView ( arg )
この関数は呼び出されたとき、以下の手順を実行します:
- argが
オブジェクトでない場合 、false を返す。 - arg が [[ViewedArrayBuffer]]
内部スロットを持つ場合、
true を返す。 false を返す。
25.1.5.2 ArrayBuffer.prototype
ArrayBuffer.prototype の初期値は
このプロパティは属性 { [[Writable]]:
25.1.5.3 get ArrayBuffer [ %Symbol.species% ]
ArrayBuffer[%Symbol.species%] は
this 値を返す。
この関数の
25.1.6 ArrayBuffer プロトタイプオブジェクトのプロパティ
ArrayBuffer プロトタイプオブジェクト:
- %ArrayBuffer.prototype% です。
- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。 通常のオブジェクト です。- [[ArrayBufferData]] や [[ArrayBufferByteLength]] 内部スロットは持ちません。
25.1.6.1 get ArrayBuffer.prototype.byteLength
ArrayBuffer.prototype.byteLength は
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (O) がtrue の場合、TypeError 例外を投げる。IsDetachedBuffer (O) がtrue の場合、+0 𝔽 を返す。- length を O.[[ArrayBufferByteLength]] に設定する。
𝔽 (length) を返す。
25.1.6.2 ArrayBuffer.prototype.constructor
ArrayBuffer.prototype.constructor の初期値は
25.1.6.3 get ArrayBuffer.prototype.detached
ArrayBuffer.prototype.detached は
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (O) がtrue の場合、TypeError 例外を投げる。IsDetachedBuffer (O) を返す。
25.1.6.4 get ArrayBuffer.prototype.maxByteLength
ArrayBuffer.prototype.maxByteLength は
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (O) がtrue の場合、TypeError 例外を投げる。IsDetachedBuffer (O) がtrue の場合、+0 𝔽 を返す。IsFixedLengthArrayBuffer (O) がtrue の場合:- length を O.[[ArrayBufferByteLength]] に設定する。
- それ以外の場合:
- length を O.[[ArrayBufferMaxByteLength]] に設定する。
𝔽 (length) を返す。
25.1.6.5 get ArrayBuffer.prototype.resizable
ArrayBuffer.prototype.resizable は
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (O) がtrue の場合、TypeError 例外を投げる。IsFixedLengthArrayBuffer (O) がfalse の場合、true を返す。そうでなければfalse を返す。
25.1.6.6 ArrayBuffer.prototype.resize ( newLength )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[ArrayBufferMaxByteLength]]) を実行する。 IsSharedArrayBuffer (O) がtrue の場合、TypeError 例外を投げる。- newByteLength を ?
ToIndex (newLength) に設定する。 IsDetachedBuffer (O) がtrue の場合、TypeError 例外を投げる。- newByteLength > O.[[ArrayBufferMaxByteLength]]
の場合、
RangeError 例外を投げる。 - hostHandled を ?
HostResizeArrayBuffer (O, newByteLength) に設定する。 - hostHandled が
handled の場合、undefined を返す。 - oldBlock を O.[[ArrayBufferData]] に設定する。
- newBlock を ?
CreateByteDataBlock (newByteLength) に設定する。 - copyLength を
min (newByteLength, O.[[ArrayBufferByteLength]]) に設定する。 CopyDataBlockBytes (newBlock, 0, oldBlock, 0, copyLength) を実行する。- 注: 新しい
Data Block の生成や古いData Block からのコピーは観測できません。実装はこのメソッドをインプレースの拡張や縮小として実装してもよいです。 - O.[[ArrayBufferData]] を newBlock に設定する。
- O.[[ArrayBufferByteLength]] を newByteLength に設定する。
undefined を返す。
25.1.6.7 ArrayBuffer.prototype.slice ( start, end )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (O) がtrue の場合、TypeError 例外を投げる。IsDetachedBuffer (O) がtrue の場合、TypeError 例外を投げる。- len を O.[[ArrayBufferByteLength]] に設定する。
- relativeStart を ?
ToIntegerOrInfinity (start) に設定する。 - relativeStart = -∞ の場合、first を 0 に設定する。
- それ以外で relativeStart < 0 の場合、first を
max (len + relativeStart, 0) に設定する。 - それ以外の場合、first を
min (relativeStart, len) に設定する。 - end が
undefined の場合、relativeEnd を len に、そうでなければ relativeEnd を ?ToIntegerOrInfinity (end) に設定する。 - relativeEnd = -∞ の場合、final を 0 に設定する。
- それ以外で relativeEnd < 0 の場合、final を
max (len + relativeEnd, 0) に設定する。 - それ以外の場合、final を
min (relativeEnd, len) に設定する。 - newLen を
max (final - first, 0) に設定する。 - ctor を ?
SpeciesConstructor (O,%ArrayBuffer% ) に設定する。 - new を ?
Construct (ctor, «𝔽 (newLen) ») に設定する。 - ?
RequireInternalSlot (new, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (new) がtrue の場合、TypeError 例外を投げる。IsDetachedBuffer (new) がtrue の場合、TypeError 例外を投げる。SameValue (new, O) がtrue の場合、TypeError 例外を投げる。- new.[[ArrayBufferByteLength]] <
newLen の場合、
TypeError 例外を投げる。 - 注: 上記のステップによる副作用で O がデタッチまたはリサイズされた場合があります。
IsDetachedBuffer (O) がtrue の場合、TypeError 例外を投げる。- fromBuf を O.[[ArrayBufferData]] に設定する。
- toBuf を new.[[ArrayBufferData]] に設定する。
- currentLen を O.[[ArrayBufferByteLength]] に設定する。
- first < currentLen の場合:
- count を
min (newLen, currentLen - first) に設定する。 CopyDataBlockBytes (toBuf, 0, fromBuf, first, count) を実行する。
- count を
- new を返す。
25.1.6.8 ArrayBuffer.prototype.transfer ( [ newLength ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
ArrayBufferCopyAndDetach (O, newLength,preserve-resizability ) を返す。
25.1.6.9 ArrayBuffer.prototype.transferToFixedLength ( [ newLength ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
ArrayBufferCopyAndDetach (O, newLength,fixed-length ) を返す。
25.1.6.10 ArrayBuffer.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
25.1.7 ArrayBuffer インスタンスのプロパティ
ArrayBuffer インスタンスは
[[ArrayBufferData]] が
[[ArrayBufferDetachKey]] が
25.1.8 リサイズ可能 ArrayBuffer ガイドライン
以下は
可能であればプログラムは実際の運用環境でテストすることを推奨します。利用可能な物理メモリの量はハードウェアごとに大きく異なります。同様に、仮想メモリサブシステムもハードウェアやオペレーティングシステムごとに大きく異なります。64ビットデスクトップウェブブラウザでメモリエラーなしで動作するアプリケーションでも、32ビットのモバイルウェブブラウザではメモリ不足になることがあります。
特定の最大サイズで
以下は
ホストがマルチテナント（すなわち、複数の ECMAScript
アプリケーションを同時に実行する）、例えばウェブブラウザの場合、実装が仮想メモリの事前予約によるインプレース拡張方式を選ぶ場合、32ビット/64ビット両方の実装で
ホストが仮想メモリを持たない場合（MMUなしの組み込み機器上等）、またはコピーによるリサイズのみ実装する場合は、
25.2 SharedArrayBuffer オブジェクト
25.2.1 固定長および拡張可能 SharedArrayBuffer オブジェクト
固定長 SharedArrayBufferは、生成後にバイト長が変更できない SharedArrayBuffer です。
拡張可能 SharedArrayBufferは、
生成される SharedArrayBuffer オブジェクトの種類は、
25.2.2 SharedArrayBuffer オブジェクトのための抽象操作
25.2.2.1 AllocateSharedArrayBuffer ( constructor, byteLength [ , maxByteLength ] )
抽象操作 AllocateSharedArrayBuffer は、constructor（
- slots を « [[ArrayBufferData]] » に設定する。
- maxByteLength が存在し、maxByteLength が
empty でない場合、allocatingGrowableBuffer をtrue に、そうでなければfalse に設定する。 - allocatingGrowableBuffer が
true の場合:- byteLength > maxByteLength
の場合、
RangeError 例外を投げる。 - [[ArrayBufferByteLengthData]] および [[ArrayBufferMaxByteLength]] を slots に追加する。
- byteLength > maxByteLength
の場合、
- それ以外の場合:
- [[ArrayBufferByteLength]] を slots に追加する。
- obj を ?
OrdinaryCreateFromConstructor (constructor,"%SharedArrayBuffer.prototype%" , slots) に設定する。 - allocatingGrowableBuffer が
true の場合、allocLength を maxByteLength に、そうでなければ allocLength を byteLength に設定する。 - block を ?
CreateSharedByteDataBlock (allocLength) に設定する。 - obj.[[ArrayBufferData]] を block に設定する。
- allocatingGrowableBuffer が
true の場合:アサート : byteLength ≤ maxByteLength。- byteLengthBlock を ?
CreateSharedByteDataBlock (8) に設定する。 SetValueInBuffer (byteLengthBlock, 0,biguint64 ,ℤ (byteLength),true ,seq-cst ) を実行する。- obj.[[ArrayBufferByteLengthData]] を byteLengthBlock に設定する。
- obj.[[ArrayBufferMaxByteLength]] を maxByteLength に設定する。
- それ以外の場合:
- obj.[[ArrayBufferByteLength]] を byteLength に設定する。
- obj を返す。
25.2.2.2 IsSharedArrayBuffer ( obj )
抽象操作 IsSharedArrayBuffer は、引数 obj（ArrayBuffer または SharedArrayBuffer）を取り、Boolean を返します。オブジェクトが ArrayBuffer、SharedArrayBuffer、またはそれらのサブタイプかをテストします。呼び出されたとき、以下の手順を実行します:
- bufferData を obj.[[ArrayBufferData]] に設定する。
- bufferData が
null の場合、false を返す。 - bufferData が
Data Block の場合、false を返す。 アサート : bufferData はShared Data Block であること。true を返す。
25.2.2.3 HostGrowSharedArrayBuffer ( buffer, newByteLength )
HostGrowSharedArrayBuffer の実装は以下の要件に従う必要があります:
- 抽象操作が正常に
unhandled で完了しない場合、newByteLength が buffer の現在のバイト長より小さいか、または newByteLength が buffer.[[ArrayBufferMaxByteLength]] より大きい場合、RangeError 例外を投げる。 - isLittleEndian を
周囲のエージェント のエージェントレコード の [[LittleEndian]] フィールド値に設定する。抽象操作が正常にhandled で完了した場合、WriteSharedMemory またはReadModifyWriteSharedMemory イベントを、[[Order]] がseq-cst 、[[Payload]] がNumericToRawBytes (biguint64 , newByteLength, isLittleEndian)、[[Block]] が buffer.[[ArrayBufferByteLengthData]]、[[ByteIndex]] が 0、[[ElementSize]] が 8 のものを周囲のエージェント の候補実行 に追加する。これにより、並行して呼ばれるSharedArrayBuffer.prototype.growが「失われる」こと（何もせず黙って終了すること）が防がれる。
上記2つ目の要件は、buffer の現在のバイト長をどのように、またいつ読み取るかについては意図的に曖昧に規定されています。バイト長は基盤ハードウェア上でアトミックなread-modify-write操作によって更新されなければならないため、ロードリンク/ストアコンディショナルやロード排他/ストア排他命令ペアを使うアーキテクチャでは、ペアの命令を命令ストリーム内で近接して配置したい場合があります。そのため、SharedArrayBuffer.prototype.grow 自体は newByteLength の境界チェックを HostGrowSharedArrayBuffer の呼び出し前に行いませんし、現在のバイト長をいつ読み取るべきかについても要件はありません。
これは
HostGrowSharedArrayBuffer のデフォルト実装は、
25.2.3 SharedArrayBuffer コンストラクタ
SharedArrayBuffer
- %SharedArrayBuffer% です。
グローバルオブジェクト の"SharedArrayBuffer" プロパティの初期値です（そのプロパティが存在する場合、下記参照）。コンストラクタ として呼び出された時、新しい SharedArrayBuffer を生成し初期化します。- 関数として呼び出すことは意図されておらず、その場合は例外を投げます。
- クラス定義の
extends節の値として使うことができます。指定された SharedArrayBuffer の動作を継承するサブクラスコンストラクタ は、SharedArrayBufferコンストラクタ へのsuper呼び出しを含め、サブクラスインスタンスをSharedArrayBuffer.prototype組み込みメソッドをサポートするための内部状態で作成・初期化しなければなりません。
ArrayBuffer と異なり、SharedArrayBuffer はデタッチされることはなく、その内部 [[ArrayBufferData]] スロットが
25.2.3.1 SharedArrayBuffer ( length [ , options ] )
この関数は呼び出されたとき、以下の手順を実行します:
- NewTarget が
undefined の場合、TypeError 例外を投げる。 - byteLength を ?
ToIndex (length) に設定する。 - requestedMaxByteLength を ?
GetArrayBufferMaxByteLengthOption (options) に設定する。 - ?
AllocateSharedArrayBuffer (NewTarget, byteLength, requestedMaxByteLength) を返す。
25.2.4 SharedArrayBuffer コンストラクタのプロパティ
SharedArrayBuffer
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 - 以下のプロパティを持ちます:
25.2.4.1 SharedArrayBuffer.prototype
SharedArrayBuffer.prototype の初期値は
このプロパティは属性 { [[Writable]]:
25.2.4.2 get SharedArrayBuffer [ %Symbol.species% ]
SharedArrayBuffer[%Symbol.species%] は
this 値を返す。
この関数の
25.2.5 SharedArrayBuffer プロトタイプオブジェクトのプロパティ
SharedArrayBuffer プロトタイプオブジェクト:
- %SharedArrayBuffer.prototype% です。
- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。 通常のオブジェクト です。- [[ArrayBufferData]] や [[ArrayBufferByteLength]] 内部スロットは持ちません。
25.2.5.1 get SharedArrayBuffer.prototype.byteLength
SharedArrayBuffer.prototype.byteLength は
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (O) がfalse の場合、TypeError 例外を投げる。- length を
ArrayBufferByteLength (O,seq-cst ) に設定する。 𝔽 (length) を返す。
25.2.5.2 SharedArrayBuffer.prototype.constructor
SharedArrayBuffer.prototype.constructor の初期値は
25.2.5.3 SharedArrayBuffer.prototype.grow ( newLength )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[ArrayBufferMaxByteLength]]) を実行する。 IsSharedArrayBuffer (O) がfalse の場合、TypeError 例外を投げる。- newByteLength を ?
ToIndex (newLength) に設定する。 - hostHandled を ?
HostGrowSharedArrayBuffer (O, newByteLength) に設定する。 - hostHandled が
handled の場合、undefined を返す。 - isLittleEndian を
周囲のエージェント のエージェントレコード の [[LittleEndian]] フィールド値に設定する。 - byteLengthBlock を O.[[ArrayBufferByteLengthData]] に設定する。
- currentByteLengthRawBytes を
GetRawBytesFromSharedBlock (byteLengthBlock, 0,biguint64 ,true ,seq-cst ) に設定する。 - newByteLengthRawBytes を
NumericToRawBytes (biguint64 ,ℤ (newByteLength), isLittleEndian) に設定する。 - 繰り返す:
- 注: これは比較交換ループであり、同じバッファの並行して競合する grow が完全に順序付けされ、失われたり黙って何もしなくなることがないようにします。ループは単独で grow を試みることができた場合に終了します。
- currentByteLength を
ℝ (RawBytesToNumeric (biguint64 , currentByteLengthRawBytes, isLittleEndian)) に設定する。 - newByteLength = currentByteLength
の場合、
undefined を返す。 - newByteLength < currentByteLength または
newByteLength > O.[[ArrayBufferMaxByteLength]]
の場合、
RangeError 例外を投げる。 - byteLengthDelta を newByteLength - currentByteLength に設定する。
- byteLengthDelta バイトの新しい
Shared Data Block を作成できない場合、RangeError 例外を投げる。 - 注: 新しい
Shared Data Block の生成や利用はここでは行いません。growable SharedArrayBuffer の観測可能な振る舞いは、コンストラクタ時に最大サイズのmax サイズのShared Data Block を確保することで規定されており、このステップは実装がメモリ不足の場合RangeError を投げる要件を表します。 - readByteLengthRawBytes を
AtomicCompareExchangeInSharedBlock (byteLengthBlock, 0, 8, currentByteLengthRawBytes, newByteLengthRawBytes) に設定する。 ByteListEqual (readByteLengthRawBytes, currentByteLengthRawBytes) がtrue の場合、undefined を返す。- currentByteLengthRawBytes を readByteLengthRawBytes に設定する。
長さの比較交換による更新における偽失敗は許されません。新しい長さの境界チェックが通り、実装がメモリ不足でなければ、
SharedArrayBuffer.prototype.grow への並行呼び出しは完全に順序付けされます。例えば、2つの競合する呼び出し
sab.grow(10) と sab.grow(20)
を考えた場合、どちらか一方が必ず競争に勝ちます。sab.grow(10) の呼び出しは、たとえ
sab.grow(20) が先に行われたとしても sab を決して縮小せず、その場合は RangeError
を投げます。
25.2.5.4 get SharedArrayBuffer.prototype.growable
SharedArrayBuffer.prototype.growable は
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (O) がfalse の場合、TypeError 例外を投げる。IsFixedLengthArrayBuffer (O) がfalse の場合、true を返す。そうでなければfalse を返す。
25.2.5.5 get SharedArrayBuffer.prototype.maxByteLength
SharedArrayBuffer.prototype.maxByteLength は
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (O) がfalse の場合、TypeError 例外を投げる。IsFixedLengthArrayBuffer (O) がtrue の場合:- length を O.[[ArrayBufferByteLength]] に設定する。
- それ以外の場合:
- length を O.[[ArrayBufferMaxByteLength]] に設定する。
𝔽 (length) を返す。
25.2.5.6 SharedArrayBuffer.prototype.slice ( start, end )
このメソッドは呼び出されたとき、以下の手順を実行します:
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (O) がfalse の場合、TypeError 例外を投げる。- len を
ArrayBufferByteLength (O,seq-cst ) に設定する。 - relativeStart を ?
ToIntegerOrInfinity (start) に設定する。 - relativeStart = -∞ の場合、first を 0 に設定する。
- それ以外で relativeStart < 0 の場合、first を
max (len + relativeStart, 0) に設定する。 - それ以外の場合、first を
min (relativeStart, len) に設定する。 - end が
undefined の場合、relativeEnd を len に、そうでなければ relativeEnd を ?ToIntegerOrInfinity (end) に設定する。 - relativeEnd = -∞ の場合、final を 0 に設定する。
- それ以外で relativeEnd < 0 の場合、final を
max (len + relativeEnd, 0) に設定する。 - それ以外の場合、final を
min (relativeEnd, len) に設定する。 - newLen を
max (final - first, 0) に設定する。 - ctor を ?
SpeciesConstructor (O,%SharedArrayBuffer% ) に設定する。 - new を ?
Construct (ctor, «𝔽 (newLen) ») に設定する。 - ?
RequireInternalSlot (new, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (new) がfalse の場合、TypeError 例外を投げる。- new.[[ArrayBufferData]] が O.[[ArrayBufferData]] である場合、
TypeError 例外を投げる。 ArrayBufferByteLength (new,seq-cst ) < newLen の場合、TypeError 例外を投げる。- fromBuf を O.[[ArrayBufferData]] に設定する。
- toBuf を new.[[ArrayBufferData]] に設定する。
CopyDataBlockBytes (toBuf, 0, fromBuf, first, newLen) を実行する。- new を返す。
25.2.5.7 SharedArrayBuffer.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
25.2.6 SharedArrayBuffer インスタンスのプロパティ
SharedArrayBuffer インスタンスは
SharedArrayBuffer インスタンスは、ArrayBuffer インスタンスとは異なり、デタッチされることはありません。
25.2.7 成長可能 SharedArrayBuffer ガイドライン
以下は
可能な限りプログラムは運用環境でテストすることを推奨します。利用可能な物理メモリの量はハードウェアごとに大きく異なります。同様に、仮想メモリサブシステムもハードウェアやオペレーティングシステムごとに大きく異なります。64ビットデスクトップウェブブラウザでメモリエラーなしで動作するアプリケーションでも、32ビットのモバイルウェブブラウザではメモリ不足になることがあります。
特定の最大サイズで
u8[idx]）のための
length のロードは同期的ではありません。明示的な同期がない場合、あるプロパティアクセスが範囲内でも、同じ length や byteLength ゲッター、
以下は
成長操作は
成長したメモリは生成直後からゼロ埋めされているように見えなければならず、並行してアクセスされる場合も含みます。これはオンデマンドのゼロフィル仮想メモリページや、手動ゼロ埋めの場合は慎重な同期によって達成できます。
実際、仮想メモリを持たない
25.3 DataView オブジェクト
25.3.1 DataView オブジェクトのための抽象操作
25.3.1.1 DataView バッファ証人レコード
DataView
バッファ証人レコードは、DataView と参照するバッファのバイト長キャッシュをカプセル化するために使用される
DataView バッファ証人レコードは
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Object]] | DataView | バッファのバイト長をロードした DataView オブジェクト。 |
| [[CachedBufferByteLength]] |
非負の |
|
25.3.1.2 MakeDataViewWithBufferWitnessRecord ( obj, order )
抽象操作 MakeDataViewWithBufferWitnessRecord は、引数
obj（DataView）、order（
- buffer を obj.[[ViewedArrayBuffer]] に設定する。
IsDetachedBuffer (buffer) がtrue の場合:- byteLength を
detached に設定する。
- byteLength を
- それ以外の場合:
- byteLength を
ArrayBufferByteLength (buffer, order) に設定する。
- byteLength を
DataView バッファ証人レコード { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength } を返す。
25.3.1.3 GetViewByteLength ( viewRecord )
抽象操作 GetViewByteLength は、引数 viewRecord（
アサート :IsViewOutOfBounds (viewRecord) がfalse であること。- view を viewRecord.[[Object]] に設定する。
- view.[[ByteLength]] が
auto でない場合、view.[[ByteLength]] を返す。 アサート :IsFixedLengthArrayBuffer (view.[[ViewedArrayBuffer]]) がfalse であること。- byteOffset を view.[[ByteOffset]] に設定する。
- byteLength を viewRecord.[[CachedBufferByteLength]] に設定する。
アサート : byteLength がdetached でないこと。- byteLength - byteOffset を返す。
25.3.1.4 IsViewOutOfBounds ( viewRecord )
抽象操作 IsViewOutOfBounds は、引数 viewRecord（
- view を viewRecord.[[Object]] に設定する。
- bufferByteLength を viewRecord.[[CachedBufferByteLength]] に設定する。
アサート :IsDetachedBuffer (view.[[ViewedArrayBuffer]]) がtrue であるのは bufferByteLength がdetached の場合のみであること。- bufferByteLength が
detached の場合、true を返す。 - byteOffsetStart を view.[[ByteOffset]] に設定する。
- view.[[ByteLength]] が
auto の場合:- byteOffsetEnd を bufferByteLength に設定する。
- それ以外の場合:
- byteOffsetEnd を byteOffsetStart + view.[[ByteLength]] に設定する。
- byteOffsetStart > bufferByteLength または
byteOffsetEnd > bufferByteLength
の場合、
true を返す。 - 注: 長さ0のDataViewはアウトオブバウンズとはみなされません。
false を返す。
25.3.1.5 GetViewValue ( view, requestIndex, isLittleEndian, type )
抽象操作 GetViewValue は、引数 view（
- ?
RequireInternalSlot (view, [[DataView]]) を実行する。 アサート : view は [[ViewedArrayBuffer]]内部スロットを持つ。- getIndex を ?
ToIndex (requestIndex) に設定する。 - isLittleEndian を
ToBoolean (isLittleEndian) に設定する。 - viewOffset を view.[[ByteOffset]] に設定する。
- viewRecord を
MakeDataViewWithBufferWitnessRecord (view,unordered ) に設定する。 - 注: 境界チェックは view のバックバッファが
成長可能 SharedArrayBuffer の場合は同期操作ではありません。 IsViewOutOfBounds (viewRecord) がtrue の場合、TypeError 例外を投げる。- viewSize を
GetViewByteLength (viewRecord) に設定する。 - elementSize を
表75 の type の Element Size 値に設定する。 - getIndex + elementSize > viewSize
の場合、
RangeError 例外を投げる。 - bufferIndex を getIndex + viewOffset に設定する。
GetValueFromBuffer (view.[[ViewedArrayBuffer]], bufferIndex, type,false ,unordered , isLittleEndian) を返す。
25.3.1.6 SetViewValue ( view, requestIndex, isLittleEndian, type, value )
抽象操作 SetViewValue は、引数 view（
- ?
RequireInternalSlot (view, [[DataView]]) を実行する。 アサート : view は [[ViewedArrayBuffer]]内部スロットを持つ。- getIndex を ?
ToIndex (requestIndex) に設定する。 IsBigIntElementType (type) がtrue の場合、numberValue を ?ToBigInt (value) に設定する。- それ以外の場合、numberValue を ?
ToNumber (value) に設定する。 - isLittleEndian を
ToBoolean (isLittleEndian) に設定する。 - viewOffset を view.[[ByteOffset]] に設定する。
- viewRecord を
MakeDataViewWithBufferWitnessRecord (view,unordered ) に設定する。 - 注: 境界チェックは view のバックバッファが
成長可能 SharedArrayBuffer の場合は同期操作ではありません。 IsViewOutOfBounds (viewRecord) がtrue の場合、TypeError 例外を投げる。- viewSize を
GetViewByteLength (viewRecord) に設定する。 - elementSize を
表75 の type の Element Size 値に設定する。 - getIndex + elementSize > viewSize
の場合、
RangeError 例外を投げる。 - bufferIndex を getIndex + viewOffset に設定する。
SetValueInBuffer (view.[[ViewedArrayBuffer]], bufferIndex, type, numberValue,false ,unordered , isLittleEndian) を実行する。undefined を返す。
25.3.2 DataView コンストラクタ
DataView
- %DataView% です。
グローバルオブジェクト の"DataView" プロパティの初期値です。コンストラクタ として呼び出された時、新しい DataView を生成し初期化します。- 関数として呼び出すことは意図されておらず、その場合は例外を投げます。
- クラス定義の
extends節の値として使うことができます。指定された DataView の動作を継承するサブクラスコンストラクタ は、DataViewコンストラクタ へのsuper呼び出しを含め、サブクラスインスタンスをDataView.prototype組み込みメソッドをサポートするための内部状態で作成・初期化しなければなりません。
25.3.2.1 DataView ( buffer [ , byteOffset [ , byteLength ] ] )
この関数は呼び出されたとき、以下の手順を実行します:
- NewTarget が
undefined の場合、TypeError 例外を投げる。 - ?
RequireInternalSlot (buffer, [[ArrayBufferData]]) を実行する。 - offset を ?
ToIndex (byteOffset) に設定する。 IsDetachedBuffer (buffer) がtrue の場合、TypeError 例外を投げる。- bufferByteLength を
ArrayBufferByteLength (buffer,seq-cst ) に設定する。 - offset > bufferByteLength の場合、
RangeError 例外を投げる。 - bufferIsFixedLength を
IsFixedLengthArrayBuffer (buffer) に設定する。 - byteLength が
undefined の場合:- bufferIsFixedLength が
true の場合:- viewByteLength を bufferByteLength - offset に設定する。
- それ以外の場合:
- viewByteLength を
auto に設定する。
- viewByteLength を
- bufferIsFixedLength が
- それ以外の場合:
- viewByteLength を ?
ToIndex (byteLength) に設定する。 - offset + viewByteLength >
bufferByteLength の場合、
RangeError 例外を投げる。
- viewByteLength を ?
- O を ?
OrdinaryCreateFromConstructor (NewTarget,"%DataView.prototype%" , « [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], [[ByteOffset]] ») に設定する。 IsDetachedBuffer (buffer) がtrue の場合、TypeError 例外を投げる。- bufferByteLength を
ArrayBufferByteLength (buffer,seq-cst ) に再設定する。 - offset > bufferByteLength の場合、
RangeError 例外を投げる。 - byteLength が
undefined でない場合:- offset + viewByteLength >
bufferByteLength の場合、
RangeError 例外を投げる。
- offset + viewByteLength >
bufferByteLength の場合、
- O.[[ViewedArrayBuffer]] を buffer に設定する。
- O.[[ByteLength]] を viewByteLength に設定する。
- O.[[ByteOffset]] を offset に設定する。
- O を返す。
25.3.3 DataView コンストラクタのプロパティ
DataView
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 - 以下のプロパティを持ちます:
25.3.3.1 DataView.prototype
DataView.prototype の初期値は
このプロパティは属性 { [[Writable]]:
25.3.4 DataView プロトタイプオブジェクトのプロパティ
DataView プロトタイプオブジェクト:
- %DataView.prototype% です。
- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。 通常のオブジェクト です。- [[DataView]]、[[ViewedArrayBuffer]]、[[ByteLength]]、[[ByteOffset]]内部スロットは持ちません。
25.3.4.1 get DataView.prototype.buffer
DataView.prototype.buffer は
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[DataView]]) を実行する。 アサート : O は [[ViewedArrayBuffer]] 内部スロットを持つ。- buffer を O.[[ViewedArrayBuffer]] に設定する。
- buffer を返す。
25.3.4.2 get DataView.prototype.byteLength
DataView.prototype.byteLength は
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[DataView]]) を実行する。 アサート : O は [[ViewedArrayBuffer]] 内部スロットを持つ。- viewRecord を
MakeDataViewWithBufferWitnessRecord (O,seq-cst ) に設定する。 IsViewOutOfBounds (viewRecord) がtrue の場合、TypeError 例外を投げる。- size を
GetViewByteLength (viewRecord) に設定する。 𝔽 (size) を返す。
25.3.4.3 get DataView.prototype.byteOffset
DataView.prototype.byteOffset は
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[DataView]]) を実行する。 アサート : O は [[ViewedArrayBuffer]] 内部スロットを持つ。- viewRecord を
MakeDataViewWithBufferWitnessRecord (O,seq-cst ) に設定する。 IsViewOutOfBounds (viewRecord) がtrue の場合、TypeError 例外を投げる。- offset を O.[[ByteOffset]] に設定する。
𝔽 (offset) を返す。
25.3.4.4 DataView.prototype.constructor
DataView.prototype.constructor の初期値は
25.3.4.5 DataView.prototype.getBigInt64 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - ?
GetViewValue (view, byteOffset, littleEndian,bigint64 ) を返す。
25.3.4.6 DataView.prototype.getBigUint64 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - ?
GetViewValue (view, byteOffset, littleEndian,biguint64 ) を返す。
25.3.4.7 DataView.prototype.getFloat16 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,float16 ) を返す。
25.3.4.8 DataView.prototype.getFloat32 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,float32 ) を返す。
25.3.4.9 DataView.prototype.getFloat64 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,float64 ) を返す。
25.3.4.10 DataView.prototype.getInt8 ( byteOffset )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - ?
GetViewValue (view, byteOffset,true ,int8 ) を返す。
25.3.4.11 DataView.prototype.getInt16 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,int16 ) を返す。
25.3.4.12 DataView.prototype.getInt32 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,int32 ) を返す。
25.3.4.13 DataView.prototype.getUint8 ( byteOffset )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - ?
GetViewValue (view, byteOffset,true ,uint8 ) を返す。
25.3.4.14 DataView.prototype.getUint16 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,uint16 ) を返す。
25.3.4.15 DataView.prototype.getUint32 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,uint32 ) を返す。
25.3.4.16 DataView.prototype.setBigInt64 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - ?
SetViewValue (view, byteOffset, littleEndian,bigint64 , value) を返す。
25.3.4.17 DataView.prototype.setBigUint64 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - ?
SetViewValue (view, byteOffset, littleEndian,biguint64 , value) を返す。
25.3.4.18 DataView.prototype.setFloat16 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,float16 , value) を返す。
25.3.4.19 DataView.prototype.setFloat32 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,float32 , value) を返す。
25.3.4.20 DataView.prototype.setFloat64 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,float64 , value) を返す。
25.3.4.21 DataView.prototype.setInt8 ( byteOffset, value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - ?
SetViewValue (view, byteOffset,true ,int8 , value) を返す。
25.3.4.22 DataView.prototype.setInt16 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,int16 , value) を返す。
25.3.4.23 DataView.prototype.setInt32 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,int32 , value) を返す。
25.3.4.24 DataView.prototype.setUint8 ( byteOffset, value )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - ?
SetViewValue (view, byteOffset,true ,uint8 , value) を返す。
25.3.4.25 DataView.prototype.setUint16 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,uint16 , value) を返す。
25.3.4.26 DataView.prototype.setUint32 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、以下の手順を実行します:
- view を
this 値とする。 - littleEndian が指定されていない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,uint32 , value) を返す。
25.3.4.27 DataView.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
25.3.5 DataView インスタンスのプロパティ
DataView インスタンスは
[[DataView]] 内部スロットの値は本仕様書内では使用されません。この内部スロットが存在することで、仕様書内で
DataView
25.4 Atomics オブジェクト
Atomics オブジェクト:
- %Atomics% です。
"Atomics" プロパティの初期値としてグローバルオブジェクト に格納されます。通常のオブジェクト です。- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。 - [[Construct]] 内部メソッドを持ちません。
new演算子でコンストラクタ として使うことはできません。 - [[Call]] 内部メソッドを持ちません。関数として呼び出すことはできません。
Atomics オブジェクトは、共有メモリ配列セルに対して不可分（アトミック）に操作する関数や、
ECMAScript での共有メモリのプログラミングおよび実装に関するガイドラインについては、
25.4.1 Waiter Record
Waiter Record は Atomics.wait や Atomics.waitAsync の特定の呼び出しを表すために使われます。
Waiter Record は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[AgentSignifier]] |
|
Atomics.wait または Atomics.waitAsync を呼び出した
|
| [[PromiseCapability]] |
|
Atomics.waitAsync の場合は生成された Promise、それ以外は
|
| [[TimeoutTime]] |
非負の |
タイムアウトが発生し得る最も早い時刻。 |
| [[Result]] |
|
呼び出しの戻り値 |
25.4.2 WaiterList Record
WaiterList Record は、Atomics.wait、Atomics.waitAsync、Atomics.notify
により待機・通知される仕組みを説明するために使われます。
WaiterList Record は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Waiters]] |
|
この WaiterList が関連付けられている場所で待機中の Atomics.wait または
Atomics.waitAsync の呼び出し
|
| [[MostRecentLeaveEvent]] |
|
直近で |
WaiterList には、同じ
各 WaiterList Record は、評価時にその WaiterList Record への排他的アクセスを制御するクリティカルセクションを持ちます。一度に一つの
25.4.3 Atomics の抽象操作
25.4.3.1 ValidateIntegerTypedArray ( typedArray, waitable )
抽象操作 ValidateIntegerTypedArray は、引数 typedArray（
- taRecord を ?
ValidateTypedArray (typedArray,unordered ) に設定する。 - 注: バウンズチェックは、typedArray のバッキングバッファが
成長可能 SharedArrayBuffer の場合は同期的操作ではありません。 - waitable が
true の場合:- typedArray.[[TypedArrayName]] が
"Int32Array" でも"BigInt64Array" でもない場合、TypeError 例外を投げる。
- typedArray.[[TypedArrayName]] が
- それ以外の場合:
- type を
TypedArrayElementType (typedArray) に設定する。 IsUnclampedIntegerElementType (type) がfalse かつIsBigIntElementType (type) がfalse の場合、TypeError 例外を投げる。
- type を
- taRecord を返す。
25.4.3.2 ValidateAtomicAccess ( taRecord, requestIndex )
抽象操作 ValidateAtomicAccess は、引数 taRecord（
- length を
TypedArrayLength (taRecord) に設定する。 - accessIndex を ?
ToIndex (requestIndex) に設定する。 アサート : accessIndex ≥ 0。- accessIndex ≥ length の場合、
RangeError 例外を投げる。 - typedArray を taRecord.[[Object]] に設定する。
- elementSize を
TypedArrayElementSize (typedArray) に設定する。 - offset を typedArray.[[ByteOffset]] に設定する。
- (accessIndex × elementSize) + offset を返す。
25.4.3.3 ValidateAtomicAccessOnIntegerTypedArray ( typedArray, requestIndex )
抽象操作 ValidateAtomicAccessOnIntegerTypedArray は、引数 typedArray（
- taRecord を ?
ValidateIntegerTypedArray (typedArray,false ) に設定する。 - ?
ValidateAtomicAccess (taRecord, requestIndex) を返す。
25.4.3.4 RevalidateAtomicAccess ( typedArray, byteIndexInBuffer )
抽象操作 RevalidateAtomicAccess は、引数 typedArray（
- taRecord を
MakeTypedArrayWithBufferWitnessRecord (typedArray,unordered ) に設定する。 - 注: バウンズチェックは、typedArray のバッキングバッファが
成長可能 SharedArrayBuffer の場合は同期的操作ではありません。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外を投げる。アサート : byteIndexInBuffer ≥ typedArray.[[ByteOffset]]。- byteIndexInBuffer ≥ taRecord.[[CachedBufferByteLength]] の場合、
RangeError 例外を投げる。 unused を返す。
25.4.3.5 GetWaiterList ( block, i )
抽象操作 GetWaiterList は、引数 block（
アサート : i および i + 3 は block メモリ内で有効なバイトオフセットであること。- (block, i) で参照される
WaiterList Record を返す。
25.4.3.6 EnterCriticalSection ( WL )
抽象操作 EnterCriticalSection は、引数 WL（
アサート :周囲のエージェント はどのWaiterList Record のクリティカルセクションにも入っていないこと。- どの
エージェント も WL のクリティカルセクション にいないまで待ち、その後 WL のクリティカルセクション に入る（他のエージェント が入らないようにする）。 - WL.[[MostRecentLeaveEvent]] が
empty でない場合:- 注: WL の
クリティカルセクション が一度でも入られると、LeaveCriticalSection によってSynchronize event がセットされます。 - execution を
周囲のエージェント のAgent Record の [[CandidateExecution]] フィールドに設定する。 - eventsRecord を execution.[[EventsRecords]] のうち、[[AgentSignifier]] が
AgentSignifier () であるAgent Events Record に設定する。 - enterEvent を新しい
Synchronize event に設定する。 - enterEvent を eventsRecord.[[EventList]] に追加する。
- (WL.[[MostRecentLeaveEvent]], enterEvent) を eventsRecord.[[AgentSynchronizesWith]] に追加する。
- 注: WL の
unused を返す。
EnterCriticalSection は 競合が発生した場合、すなわち
25.4.3.7 LeaveCriticalSection ( WL )
抽象操作 LeaveCriticalSection は、引数 WL（
アサート :周囲のエージェント は WL のクリティカルセクション にいること。- execution を
周囲のエージェント のAgent Record の [[CandidateExecution]] フィールドに設定する。 - eventsRecord を execution.[[EventsRecords]] のうち、[[AgentSignifier]] が
AgentSignifier () であるAgent Events Record に設定する。 - leaveEvent を新しい
Synchronize event に設定する。 - leaveEvent を eventsRecord.[[EventList]] に追加する。
- WL.[[MostRecentLeaveEvent]] を leaveEvent に設定する。
- WL の
クリティカルセクション を退場する。 unused を返す。
25.4.3.8 AddWaiter ( WL, waiterRecord )
抽象操作 AddWaiter は、引数 WL（
アサート :周囲のエージェント は WL のクリティカルセクション にいること。アサート : WL.[[Waiters]] に waiterRecord.[[PromiseCapability]] および waiterRecord.[[AgentSignifier]] が等しいWaiter Record が存在しないこと。- waiterRecord を WL.[[Waiters]] に追加する。
unused を返す。
25.4.3.9 RemoveWaiter ( WL, waiterRecord )
抽象操作 RemoveWaiter は、引数 WL（
アサート :周囲のエージェント は WL のクリティカルセクション にいること。アサート : WL.[[Waiters]] に waiterRecord が含まれていること。- waiterRecord を WL.[[Waiters]] から削除する。
unused を返す。
25.4.3.10 RemoveWaiters ( WL, c )
抽象操作 RemoveWaiters は、引数 WL（
アサート :周囲のエージェント は WL のクリティカルセクション にいること。- len を WL.[[Waiters]] の要素数に設定する。
- n を
min (c, len) に設定する。 - L を
List 型で、WL.[[Waiters]] の最初の n 要素で構成する。 - WL.[[Waiters]] の最初の n 要素を削除する。
- L を返す。
25.4.3.11 SuspendThisAgent ( WL, waiterRecord )
抽象操作 SuspendThisAgent は、引数 WL（
アサート :周囲のエージェント は WL のクリティカルセクション にいること。アサート : WL.[[Waiters]] に waiterRecord が含まれていること。- thisAgent を
AgentSignifier () に設定する。 アサート : waiterRecord.[[AgentSignifier]] が thisAgent であること。アサート : waiterRecord.[[PromiseCapability]] がblocking であること。アサート :AgentCanSuspend () がtrue であること。LeaveCriticalSection (WL) を実行し、周囲のエージェント を waiterRecord.[[TimeoutTime]] までサスペンドする。この複合操作は、クリティカルセクション退出後サスペンド前に通知が届いた場合に通知が失われないように行う。周囲のエージェント はタイムアウトまたは他のエージェント がNotifyWaiter を WL, thisAgent で呼ぶ（つまりAtomics.notify）ことでのみサスペンドから復帰できる。EnterCriticalSection (WL) を実行する。unused を返す。
25.4.3.12 NotifyWaiter ( WL, waiterRecord )
抽象操作 NotifyWaiter は、引数 WL（
アサート :周囲のエージェント は WL のクリティカルセクション にいること。- waiterRecord.[[PromiseCapability]] が
blocking の場合:- waiterRecord.[[AgentSignifier]] の
エージェント をサスペンドから復帰させる。 - 注: これにより
エージェント はSuspendThisAgent 内で処理を再開する。
- waiterRecord.[[AgentSignifier]] の
- それ以外で
AgentSignifier () が waiterRecord.[[AgentSignifier]] の場合:- promiseCapability を waiterRecord.[[PromiseCapability]] に設定する。
- !
Call (promiseCapability.[[Resolve]],undefined , « waiterRecord.[[Result]] ») を実行する。
- それ以外の場合:
EnqueueResolveInAgentJob (waiterRecord.[[AgentSignifier]], waiterRecord.[[PromiseCapability]], waiterRecord.[[Result]]) を実行する。
unused を返す。
25.4.3.13 EnqueueResolveInAgentJob ( agentSignifier, promiseCapability, resolution )
抽象操作 EnqueueResolveInAgentJob は、引数 agentSignifier（
- resolveJob を、引数なしで
agentSignifier、promiseCapability、resolution
をキャプチャし、呼び出されたときに以下の手順を実行する新しい
Job 抽象クロージャ に設定する:アサート :AgentSignifier () が agentSignifier であること。- !
Call (promiseCapability.[[Resolve]],undefined , « resolution » ) を実行する。 unused を返す。
- realmInTargetAgent を !
GetFunctionRealm (promiseCapability.[[Resolve]]) に設定する。 アサート : agentSignifier が realmInTargetAgent.[[AgentSignifier]] であること。HostEnqueueGenericJob (resolveJob, realmInTargetAgent) を実行する。unused を返す。
25.4.3.14 DoWait ( mode, typedArray, index, value, timeout )
抽象操作 DoWait は、引数 mode（
- taRecord を ?
ValidateIntegerTypedArray (typedArray,true ) に設定する。 - buffer を taRecord.[[Object]].[[ViewedArrayBuffer]] に設定する。
IsSharedArrayBuffer (buffer) がfalse の場合、TypeError 例外を投げる。- i を ?
ValidateAtomicAccess (taRecord, index) に設定する。 - arrayTypeName を typedArray.[[TypedArrayName]] に設定する。
- arrayTypeName が
"BigInt64Array" の場合、v を ?ToBigInt64 (value) に設定する。 - それ以外の場合、v を ?
ToInt32 (value) に設定する。 - q を ?
ToNumber (timeout) に設定する。 - q が
NaN または+∞ 𝔽 の場合、t を +∞ に、そうでなければ q が-∞ 𝔽 の場合 t を 0 に、それ以外の場合 t をmax (ℝ (q), 0) に設定する。 - mode が
sync かつAgentCanSuspend () がfalse の場合、TypeError 例外を投げる。 - block を buffer.[[ArrayBufferData]] に設定する。
- offset を typedArray.[[ByteOffset]] に設定する。
- byteIndexInBuffer を (i × 4) + offset に設定する。
- WL を
GetWaiterList (block, byteIndexInBuffer) に設定する。 - mode が
sync の場合:- promiseCapability を
blocking に設定する。 - resultObject を
undefined に設定する。
- promiseCapability を
- それ以外の場合:
- promiseCapability を !
NewPromiseCapability (%Promise% ) に設定する。 - resultObject を
OrdinaryObjectCreate (%Object.prototype% ) に設定する。
- promiseCapability を !
EnterCriticalSection (WL) を実行する。- elementType を
TypedArrayElementType (typedArray) に設定する。 - w を
GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst ) に設定する。 - v ≠ w の場合:
LeaveCriticalSection (WL) を実行する。- mode が
sync の場合、"not-equal" を返す。 - !
CreateDataPropertyOrThrow (resultObject,"async" ,false ) を実行する。 - !
CreateDataPropertyOrThrow (resultObject,"value" ,"not-equal" ) を実行する。 - resultObject を返す。
- t = 0 かつ mode が
async の場合:- 注: 同期の即時タイムアウトには特別な処理はありません。非同期の即時タイムアウトは、速やかに失敗し不要な Promise ジョブを避けるため特別な処理をします。
LeaveCriticalSection (WL) を実行する。- !
CreateDataPropertyOrThrow (resultObject,"async" ,false ) を実行する。 - !
CreateDataPropertyOrThrow (resultObject,"value" ,"timed-out" ) を実行する。 - resultObject を返す。
- thisAgent を
AgentSignifier () に設定する。 - now を
現在時刻の時刻値 (UTC) に設定する。 - additionalTimeout を
実装依存 の非負数学値 に設定する。 - timeoutTime を
ℝ (now) + t + additionalTimeout に設定する。 - 注: t が +∞ の場合、timeoutTime も +∞ になります。
- waiterRecord を新しい
Waiter Record { [[AgentSignifier]]: thisAgent, [[PromiseCapability]]: promiseCapability, [[TimeoutTime]]: timeoutTime, [[Result]]:"ok" } に設定する。 AddWaiter (WL, waiterRecord) を実行する。- mode が
sync の場合:SuspendThisAgent (WL, waiterRecord) を実行する。
- それ以外で timeoutTime が
有限 の場合:EnqueueAtomicsWaitAsyncTimeoutJob (WL, waiterRecord) を実行する。
LeaveCriticalSection (WL) を実行する。- mode が
sync の場合、waiterRecord.[[Result]] を返す。 - !
CreateDataPropertyOrThrow (resultObject,"async" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (resultObject,"value" , promiseCapability.[[Promise]]) を実行する。 - resultObject を返す。
additionalTimeout は、消費電力削減やタイミング攻撃の緩和のためにタイマー解像度を粗くするなど、実装がタイムアウトを必要に応じて調整するために利用できます。この値は DoWait の呼び出しごとに異なる場合があります。
25.4.3.15 EnqueueAtomicsWaitAsyncTimeoutJob ( WL, waiterRecord )
抽象操作 EnqueueAtomicsWaitAsyncTimeoutJob は、引数 WL（
- timeoutJob を、引数なしで WL と waiterRecord
をキャプチャし、呼び出されたときに以下の手順を実行する新しい
Job 抽象クロージャ に設定する:EnterCriticalSection (WL) を実行する。- WL.[[Waiters]] が waiterRecord
を含む場合:
- timeOfJobExecution を
現在時刻の時刻値 (UTC) に設定する。 アサート :ℝ (timeOfJobExecution) ≥ waiterRecord.[[TimeoutTime]]（時刻値 の非単調性は無視）。- waiterRecord.[[Result]] を
"timed-out" に設定する。 RemoveWaiter (WL, waiterRecord) を実行する。NotifyWaiter (WL, waiterRecord) を実行する。
- timeOfJobExecution を
LeaveCriticalSection (WL) を実行する。unused を返す。
- now を
現在時刻の時刻値 (UTC) に設定する。 - currentRealm を
現在の Realm Record に設定する。 HostEnqueueTimeoutJob (timeoutJob, currentRealm,𝔽 (waiterRecord.[[TimeoutTime]]) - now) を実行する。unused を返す。
25.4.3.16 AtomicCompareExchangeInSharedBlock ( block, byteIndexInBuffer, elementSize, expectedBytes, replacementBytes )
抽象操作 AtomicCompareExchangeInSharedBlock は、引数 block（
- execution を
周囲のエージェント のAgent Record の [[CandidateExecution]] フィールドに設定する。 - eventsRecord を execution.[[EventsRecords]] のうち、[[AgentSignifier]] が
AgentSignifier () であるAgent Events Record に設定する。 - rawBytesRead を elementSize の長さを持つ
List で、要素は非決定的に選ばれたバイト値 とする。 - 注: 実装では、rawBytesRead
はハードウェア上のロードリンク、ロードエクスクルーシブ、またはリード・モディファイ・ライト命令のオペランドの結果です。非決定性は、
メモリモデル の意味的規定であり、弱い一貫性のハードウェアの観測可能な振る舞いを記述します。 - 注: 期待値と読込値の比較は、期待値が読込値と等しくない場合に不必要な強い同期を避けるため、
read-modify-write 修飾関数 の外側で行われます。 ByteListEqual (rawBytesRead, expectedBytes) がtrue の場合:- second を新しい
read-modify-write 修飾関数 （パラメータ (oldBytes, newBytes)、何もキャプチャせず、呼び出されたときに以下を原子的に実行: newBytes を返す）に設定する。 - event を
ReadModifyWriteSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize, [[Payload]]: replacementBytes, [[ModifyOp]]: second } に設定する。
- second を新しい
- それ以外の場合:
- event を
ReadSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize } に設定する。
- event を
- event を eventsRecord.[[EventList]] に追加する。
Chosen Value Record { [[Event]]: event, [[ChosenValue]]: rawBytesRead } を execution.[[ChosenValues]] に追加する。- rawBytesRead を返す。
25.4.3.17 AtomicReadModifyWrite ( typedArray, index, value, op )
抽象操作 AtomicReadModifyWrite は、引数 typedArray（
- byteIndexInBuffer を ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index) に設定する。 - typedArray.[[ContentType]] が
bigint の場合、v を ?ToBigInt (value) に設定する。 - それ以外の場合、v を
𝔽 (?ToIntegerOrInfinity (value)) に設定する。 - ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer) を実行する。 - buffer を typedArray.[[ViewedArrayBuffer]] に設定する。
- elementType を
TypedArrayElementType (typedArray) に設定する。 GetModifySetValueInBuffer (buffer, byteIndexInBuffer, elementType, v, op) を返す。
25.4.3.18 ByteListBitwiseOp ( op, xBytes, yBytes )
抽象操作 ByteListBitwiseOp は、引数 op（&, ^,
|）、xBytes（
アサート : xBytes と yBytes は同じ数の要素を持つ。- result を新しい空の
List に設定する。 - i を 0 に設定する。
- xBytes の各要素 xByte について、以下を行う:
- yByte を yBytes[i] に設定する。
- op が
&の場合:- resultByte を xByte と yByte にビットAND演算を適用した結果に設定する。
- それ以外で op が
^の場合:- resultByte を xByte と yByte にビットXOR演算を適用した結果に設定する。
- それ以外の場合:
アサート : op は|である。- resultByte を xByte と yByte にビットOR演算を適用した結果に設定する。
- i を i + 1 に設定する。
- resultByte を result に追加する。
- result を返す。
25.4.3.19 ByteListEqual ( xBytes, yBytes )
抽象操作 ByteListEqual は、引数 xBytes（
- xBytes と yBytes の要素数が異なる場合、
false を返す。 - i を 0 に設定する。
- xBytes の各要素 xByte について、以下を行う:
- yByte を yBytes[i] に設定する。
- xByte ≠ yByte の場合、
false を返す。 - i を i + 1 に設定する。
true を返す。
25.4.4 Atomics.add ( typedArray, index, value )
この関数は呼び出されたとき、以下の手順を実行します:
- add を次のパラメータ (xBytes, yBytes) を持ち、typedArray
をキャプチャし、呼び出されたときに原子的に以下の手順を実行する新しい
read-modify-write 修飾関数 に設定する:- type を
TypedArrayElementType (typedArray) に設定する。 - isLittleEndian を
周囲のエージェント のAgent Record の [[LittleEndian]] フィールドの値に設定する。 - x を
RawBytesToNumeric (type, xBytes, isLittleEndian) に設定する。 - y を
RawBytesToNumeric (type, yBytes, isLittleEndian) に設定する。 - x が
Number の場合:- sum を
Number::add (x, y) に設定する。
- sum を
- それ以外の場合:
Assert : x はBigInt である。- sum を
BigInt::add (x, y) に設定する。
- sumBytes を
NumericToRawBytes (type, sum, isLittleEndian) に設定する。 Assert : sumBytes, xBytes, yBytes は同じ数の要素を持つ。- sumBytes を返す。
- type を
- ?
AtomicReadModifyWrite (typedArray, index, value, add) を返す。
25.4.5 Atomics.and ( typedArray, index, value )
この関数は呼び出されたとき、以下の手順を実行します:
- and を、パラメータ (xBytes, yBytes)
を持ち、何もキャプチャせず、呼び出されたときに原子的に以下の手順を実行する新しい
read-modify-write 修飾関数 に設定する:ByteListBitwiseOp (&, xBytes, yBytes) を返す。
- ?
AtomicReadModifyWrite (typedArray, index, value, and) を返す。
25.4.6 Atomics.compareExchange ( typedArray, index, expectedValue, replacementValue )
この関数は呼び出されたとき、以下の手順を実行します:
- byteIndexInBuffer を ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index) に設定する。 - buffer を typedArray.[[ViewedArrayBuffer]] に設定する。
- block を buffer.[[ArrayBufferData]] に設定する。
- typedArray.[[ContentType]] が
bigint の場合: - それ以外の場合:
- expected を
𝔽 (?ToIntegerOrInfinity (expectedValue)) に設定する。 - replacement を
𝔽 (?ToIntegerOrInfinity (replacementValue)) に設定する。
- expected を
- ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer) を実行する。 - elementType を
TypedArrayElementType (typedArray) に設定する。 - elementSize を
TypedArrayElementSize (typedArray) に設定する。 - isLittleEndian を
周囲のエージェント のAgent Record の [[LittleEndian]] フィールドの値に設定する。 - expectedBytes を
NumericToRawBytes (elementType, expected, isLittleEndian) に設定する。 - replacementBytes を
NumericToRawBytes (elementType, replacement, isLittleEndian) に設定する。 IsSharedArrayBuffer (buffer) がtrue の場合:- rawBytesRead を
AtomicCompareExchangeInSharedBlock (block, byteIndexInBuffer, elementSize, expectedBytes, replacementBytes) に設定する。
- rawBytesRead を
- それ以外の場合:
- rawBytesRead を elementSize の長さを持つ
List で、要素は block[byteIndexInBuffer] から始まる elementSize バイトの並びに設定する。 ByteListEqual (rawBytesRead, expectedBytes) がtrue の場合:- replacementBytes の個々のバイトを block の block[byteIndexInBuffer] から順に格納する。
- rawBytesRead を elementSize の長さを持つ
RawBytesToNumeric (elementType, rawBytesRead, isLittleEndian) を返す。
25.4.7 Atomics.exchange ( typedArray, index, value )
この関数は呼び出されたとき、以下の手順を実行します:
- second を、パラメータ (oldBytes, newBytes)
を持ち、何もキャプチャせず、呼び出されたときに原子的に以下の手順を実行する新しい
read-modify-write 修飾関数 に設定する:- newBytes を返す。
- ?
AtomicReadModifyWrite (typedArray, index, value, second) を返す。
25.4.8 Atomics.isLockFree ( size )
この関数は呼び出されたとき、以下の手順を実行します:
- n を ?
ToIntegerOrInfinity (size) に設定する。 - AR を
Agent Record の周囲のエージェント に設定する。 - n = 1 の場合、AR.[[IsLockFree1]] を返す。
- n = 2 の場合、AR.[[IsLockFree2]] を返す。
- n = 4 の場合、
true を返す。 - n = 8 の場合、AR.[[IsLockFree8]] を返す。
false を返す。
この関数は最適化プリミティブです。直感的には、データサイズ n
バイトのアトミックプリミティブ（compareExchange、load、store、add、sub、and、or、xor、exchange）のアトミックステップが、データを構成する
n バイトの外側でロックを取得することなく実行される場合、Atomics.isLockFree(n) は
Atomics.isLockFree(4) は常に
この関数の返す値に関わらず、すべてのアトミック操作はアトミック性が保証されています。例えば、操作の途中で目に見える変更（tearing）が発生することは決してありません。
25.4.9 Atomics.load ( typedArray, index )
この関数は呼び出されたとき、以下の手順を実行します:
- byteIndexInBuffer を ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index) に設定する。 - ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer) を実行する。 - buffer を typedArray.[[ViewedArrayBuffer]] に設定する。
- elementType を
TypedArrayElementType (typedArray) に設定する。 GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst ) を返す。
25.4.10 Atomics.or ( typedArray, index, value )
この関数は呼び出されたとき、以下の手順を実行します:
- or を、パラメータ (xBytes, yBytes)
を持ち、何もキャプチャせず、呼び出されたときに原子的に以下の手順を実行する新しい
read-modify-write 修飾関数 に設定する:ByteListBitwiseOp (|, xBytes, yBytes) を返す。
- ?
AtomicReadModifyWrite (typedArray, index, value, or) を返す。
25.4.11 Atomics.store ( typedArray, index, value )
この関数は呼び出されたとき、以下の手順を実行します:
- byteIndexInBuffer を ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index) に設定する。 - typedArray.[[ContentType]] が
bigint の場合、v を ?ToBigInt (value) に設定する。 - それ以外の場合、v を
𝔽 (?ToIntegerOrInfinity (value)) に設定する。 - ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer) を実行する。 - buffer を typedArray.[[ViewedArrayBuffer]] に設定する。
- elementType を
TypedArrayElementType (typedArray) に設定する。 SetValueInBuffer (buffer, byteIndexInBuffer, elementType, v,true ,seq-cst ) を実行する。- v を返す。
25.4.12 Atomics.sub ( typedArray, index, value )
この関数は呼び出されたとき、以下の手順を実行します:
- subtract を、パラメータ (xBytes, yBytes)
を持ち、typedArray をキャプチャし、呼び出されたときに原子的に以下の手順を実行する新しい
read-modify-write 修飾関数 に設定する:- type を
TypedArrayElementType (typedArray) に設定する。 - isLittleEndian を
周囲のエージェント のAgent Record の [[LittleEndian]] フィールドの値に設定する。 - x を
RawBytesToNumeric (type, xBytes, isLittleEndian) に設定する。 - y を
RawBytesToNumeric (type, yBytes, isLittleEndian) に設定する。 - x が
Number の場合:- difference を
Number::subtract (x, y) に設定する。
- difference を
- それ以外の場合:
Assert : x はBigInt である。- difference を
BigInt::subtract (x, y) に設定する。
- differenceBytes を
NumericToRawBytes (type, difference, isLittleEndian) に設定する。 Assert : differenceBytes, xBytes, yBytes は同じ数の要素を持つ。- differenceBytes を返す。
- type を
- ?
AtomicReadModifyWrite (typedArray, index, value, subtract) を返す。
25.4.13 Atomics.wait ( typedArray, index, value, timeout )
この関数は、
呼び出されたとき、以下の手順を実行します:
- ?
DoWait (sync , typedArray, index, value, timeout) を返す。
25.4.14 Atomics.waitAsync ( typedArray, index, value, timeout )
この関数は、呼び出し元
呼び出されたとき、以下の手順を実行します:
- ?
DoWait (async , typedArray, index, value, timeout) を返す。
25.4.15 Atomics.notify ( typedArray, index, count )
この関数は待機キューでスリープしている
呼び出されたとき、以下の手順を実行します:
- taRecord を ?
ValidateIntegerTypedArray (typedArray,true ) に設定する。 - byteIndexInBuffer を ?
ValidateAtomicAccess (taRecord, index) に設定する。 - count が
undefined の場合:- c を +∞ に設定する。
- それ以外の場合:
- intCount を ?
ToIntegerOrInfinity (count) に設定する。 - c を
max (intCount, 0) に設定する。
- intCount を ?
- buffer を typedArray.[[ViewedArrayBuffer]] に設定する。
- block を buffer.[[ArrayBufferData]] に設定する。
IsSharedArrayBuffer (buffer) がfalse の場合、+0 𝔽 を返す。- WL を
GetWaiterList (block, byteIndexInBuffer) に設定する。 EnterCriticalSection (WL) を実行する。- S を
RemoveWaiters (WL, c) に設定する。 - S の各要素 W について、以下を行う:
NotifyWaiter (WL, W) を実行する。
LeaveCriticalSection (WL) を実行する。- n を S の要素数に設定する。
𝔽 (n) を返す。
25.4.16 Atomics.xor ( typedArray, index, value )
この関数は呼び出されたとき、以下の手順を実行します:
- xor を、パラメータ (xBytes, yBytes)
を持ち、何もキャプチャせず、呼び出されたときに原子的に以下の手順を実行する新しい
read-modify-write 修飾関数 に設定する:ByteListBitwiseOp (^, xBytes, yBytes) を返す。
- ?
AtomicReadModifyWrite (typedArray, index, value, xor) を返す。
25.4.17 Atomics [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
25.5 JSON オブジェクト
JSON オブジェクト:
- %JSON% です。
"JSON" プロパティの初期値としてグローバルオブジェクト に格納されます。通常のオブジェクト です。- JSONテキストを構文解析・構築するための
parseおよびstringifyの2つの関数を含みます。 - [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。 - [[Construct]] 内部メソッドを持ちません。
new演算子でコンストラクタ として使うことはできません。 - [[Call]] 内部メソッドを持ちません。関数として呼び出すことはできません。
JSONデータ交換フォーマットは ECMA-404 で定義されています。本仕様で用いられる JSON交換フォーマットは、ECMA-404
で記述されたものと完全に同一です。JSON.parse および JSON.stringify の準拠実装は、ECMA-404
仕様書で記述された交換フォーマットを削除や拡張なしに正確にサポートしなければなりません。
25.5.1 JSON.parse ( text [ , reviver ] )
この関数は JSON テキスト（JSON 形式の文字列）を構文解析し、
省略可能な reviver パラメータは、key と value
の2つのパラメータを取る関数です。解析結果のフィルタや変換が可能で、解析によって生成された各 key/value
ペアに対して呼び出され、戻り値が元の値の代わりに利用されます。受け取った値をそのまま返す場合は構造は修正されません。
- jsonString を ?
ToString (text) に設定する。 - unfiltered を ?
ParseJSON (jsonString) に設定する。 IsCallable (reviver) がtrue の場合:- root を
OrdinaryObjectCreate (%Object.prototype% ) に設定する。 - rootName を空文字列に設定する。
- !
CreateDataPropertyOrThrow (root, rootName, unfiltered) を実行する。 - ?
InternalizeJSONProperty (root, rootName, reviver) を返す。
- root を
- それ以外の場合:
- unfiltered を返す。
この関数の
25.5.1.1 ParseJSON ( text )
抽象操作 ParseJSON は、引数 text（文字列）を取り、
StringToCodePoints (text) が ECMA-404 で規定された有効な JSON テキストでない場合、SyntaxError 例外を投げる。- scriptString を
文字列連結 で"(" , text,");" を連結した値に設定する。 - script を
ParseText (scriptString,Script ) に設定する。 - 注:
早期エラー の規則（13.2.5.1 ）は、上記のParseText の呼び出しについて特別な扱いがあります。 Assert : script は構文ノード である。- result を !
Evaluation (script) に設定する。 - 注:
PropertyDefinitionEvaluation の意味（13.2.5.5 ）は、上記の評価で特別な扱いがあります。 Assert : result は String、Number、Boolean、ArrayLiteral やObjectLiteral で定義されるオブジェクト、またはnull のいずれかである。- result を返す。
準拠する JSON.parse の実装が JSON 文法を拡張することは許されません。拡張または修正された JSON
交換フォーマットをサポートしたい場合は、別の parse 関数を定義する必要があります。
有効な JSON テキストは ECMAScript の
ただし、
オブジェクト内に重複した名前文字列がある場合、同じキーに対する先行する値は上書きされます。
25.5.1.2 InternalizeJSONProperty ( holder, name, reviver )
抽象操作 InternalizeJSONProperty は、引数
holder（オブジェクト）、name（文字列）、reviver（
このアルゴリズムは、[[Delete]] や
呼び出されたとき、以下の手順を実行します:
- val を ?
Get (holder, name) に設定する。 - val が
オブジェクト の場合:- isArray を ?
IsArray (val) に設定する。 - isArray が
true の場合:- len を ?
LengthOfArrayLike (val) に設定する。 - I を 0 に設定する。
- I < len の間、繰り返す:
- prop を !
ToString (𝔽 (I)) に設定する。 - newElement を ?
InternalizeJSONProperty (val, prop, reviver) に設定する。 - newElement が
undefined の場合:- ? val.[[Delete]](prop) を実行する。
- それ以外の場合:
- ?
CreateDataProperty (val, prop, newElement) を実行する。
- ?
- I を I + 1 に設定する。
- prop を !
- len を ?
- それ以外の場合:
- keys を ?
EnumerableOwnProperties (val,key ) に設定する。 - keys の各文字列 P について、以下を行う:
- newElement を ?
InternalizeJSONProperty (val, P, reviver) に設定する。 - newElement が
undefined の場合:- ? val.[[Delete]](P) を実行する。
- それ以外の場合:
- ?
CreateDataProperty (val, P, newElement) を実行する。
- ?
- newElement を ?
- keys を ?
- isArray を ?
- ?
Call (reviver, holder, « name, val ») を返す。
25.5.2 JSON.stringify ( value [ , replacer [ , space ] ] )
この関数は、
呼び出されたとき、以下の手順を実行します:
- stack を新しい空の
List に設定する。 - indent を空文字列に設定する。
- PropertyList を
undefined に設定する。 - ReplacerFunction を
undefined に設定する。 - replacer が
オブジェクト の場合:IsCallable (replacer) がtrue の場合:- ReplacerFunction を replacer に設定する。
- それ以外の場合:
- isArray を ?
IsArray (replacer) に設定する。 - isArray が
true の場合:- PropertyList を新しい空の
List に設定する。 - len を ?
LengthOfArrayLike (replacer) に設定する。 - k を 0 に設定する。
- k < len の間、繰り返す:
- prop を !
ToString (𝔽 (k)) に設定する。 - v を ?
Get (replacer, prop) に設定する。 - item を
undefined に設定する。 - v が
String の場合:- item を v に設定する。
- それ以外で v が
Number の場合:- item を !
ToString (v) に設定する。
- item を !
- それ以外で v が
オブジェクト の場合:- v が [[StringData]] または [[NumberData]]
内部スロットを持つ場合、item を ?
ToString (v) に設定する。
- v が [[StringData]] または [[NumberData]]
内部スロットを持つ場合、item を ?
- item が
undefined でない、かつ PropertyList に item が含まれていない場合:- item を PropertyList に追加する。
- k を k + 1 に設定する。
- prop を !
- PropertyList を新しい空の
- isArray を ?
- space が
オブジェクト の場合: - space が
Number の場合:- spaceMV を !
ToIntegerOrInfinity (space) に設定する。 - spaceMV を
min (10, spaceMV) に設定する。 - spaceMV < 1 の場合は gap を空文字列、そうでなければ gap を code unit 0x0020 (SPACE) を spaceMV 回繰り返した文字列に設定する。
- spaceMV を !
- それ以外で space が
String の場合:- space の長さが 10 以下なら gap を space、そうでなければ
gap を
substring (space, 0, 10) に設定する。
- space の長さが 10 以下なら gap を space、そうでなければ
gap を
- それ以外の場合:
- gap を空文字列に設定する。
- wrapper を
OrdinaryObjectCreate (%Object.prototype% ) に設定する。 - !
CreateDataPropertyOrThrow (wrapper, 空文字列, value) を実行する。 - state を
JSON Serialization Record { [[ReplacerFunction]]: ReplacerFunction, [[Stack]]: stack, [[Indent]]: indent, [[Gap]]: gap, [[PropertyList]]: PropertyList } に設定する。 - ?
SerializeJSONProperty (state, 空文字列, wrapper) を返す。
この関数の
JSON 構造は任意の深さにネスト可能ですが、循環構造であってはなりません。value が循環構造である場合、この関数は
a = [];
a[0] = a;
my_text = JSON.stringify(a); // これは TypeError を投げなければならない。記号的なプリミティブ値は以下のようにレンダリングされます:
-
null は JSON テキストで文字列値"null" として表現されます。 -
undefined は出力されません。 -
true は JSON テキストで文字列値"true" として表現されます。 -
false は JSON テキストで文字列値"false" として表現されます。
文字列値は QUOTATION MARK (") で囲まれます。コード単位 " および \ は
\ を前置してエスケープされます。制御文字コード単位は \uHHHH のエスケープシーケンス、または短縮形
\b（BACKSPACE）、\f（FORM FEED）、\n（LINE
FEED）、\r（CARRIAGE RETURN）、\t（CHARACTER TABULATION）で置き換えられます。
JSON 表現を持たない値（
オブジェクトは U+007B（LEFT CURLY BRACKET）で始まり、0個以上のプロパティを U+002C（COMMA）で区切り、U+007D（RIGHT CURLY
BRACKET）で閉じます。プロパティは
25.5.2.1 JSON シリアライゼーションレコード
JSON シリアライゼーションレコード は、JSON
形式へのシリアライズを可能にする
JSON シリアライゼーションレコードは
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ReplacerFunction]] | オブジェクトプロパティの置換値を供給する関数（JSON.stringify の replacer パラメータ由来） | |
| [[PropertyList]] | 非配列オブジェクトのシリアライズ時に含めるプロパティ名（JSON.stringify の replacer パラメータ由来） | |
| [[Gap]] | 文字列 | インデント単位（JSON.stringify の space パラメータ由来） |
| [[Stack]] | シリアライズ中のネストされたオブジェクト集合。循環構造検出用。 | |
| [[Indent]] | 文字列 | 現在のインデント。 |
25.5.2.2 SerializeJSONProperty ( state, key, holder )
抽象操作 SerializeJSONProperty は、引数 state（
- value を ?
Get (holder, key) に設定する。 - value が
オブジェクト または value がBigInt の場合:- toJSON を ?
GetV (value,"toJSON" ) に設定する。 IsCallable (toJSON) がtrue の場合:- value を ?
Call (toJSON, value, « key ») に設定する。
- value を ?
- toJSON を ?
- state.[[ReplacerFunction]] が
undefined でない場合:- value を ?
Call (state.[[ReplacerFunction]], holder, « key, value ») に設定する。
- value を ?
- value が
オブジェクト の場合:- value が [[NumberData]] 内部スロットを持つ場合:
- value を ?
ToNumber (value) に設定する。
- value を ?
- それ以外で value が [[StringData]]
内部スロットを持つ場合:
- value を ?
ToString (value) に設定する。
- value を ?
- それ以外で value が [[BooleanData]]
内部スロットを持つ場合:
- value を value.[[BooleanData]] に設定する。
- それ以外で value が [[BigIntData]]
内部スロットを持つ場合:
- value を value.[[BigIntData]] に設定する。
- value が [[NumberData]] 内部スロットを持つ場合:
- value が
null の場合、"null" を返す。 - value が
true の場合、"true" を返す。 - value が
false の場合、"false" を返す。 - value が
String の場合、QuoteJSONString (value) を返す。 - value が
Number の場合: - value が
BigInt の場合、TypeError 例外を投げる。 - value が
オブジェクト かつIsCallable (value) がfalse の場合:- isArray を ?
IsArray (value) に設定する。 - isArray が
true の場合、?SerializeJSONArray (state, value) を返す。 - ?
SerializeJSONObject (state, value) を返す。
- isArray を ?
undefined を返す。
25.5.2.3 QuoteJSONString ( value )
抽象操作 QuoteJSONString は、引数 value（文字列）を取り、文字列を返します。value を
0x0022（引用符）コード単位で囲み、内部の特定のコード単位をエスケープします。この操作は value を
- product をコード単位 0x0022（引用符）のみからなる文字列値に設定する。
StringToCodePoints (value) の各コードポイント C について、以下を行う:- C が
表81 の「コードポイント」欄に記載されている場合:- product を
文字列連結 で product と、その行の「エスケープシーケンス」欄で指定された C のエスケープシーケンスを連結した値に設定する。
- product を
- それ以外で C の数値が 0x0020（スペース）より小さいか、C の数値が
リードサロゲート またはトレイリングサロゲート と同じ場合:- unit を C の数値と同じ値のコード単位に設定する。
- product を
文字列連結 で product とUnicodeEscape (unit) を連結した値に設定する。
- それ以外の場合:
- product を
文字列連結 で product とUTF16EncodeCodePoint (C) を連結した値に設定する。
- product を
- C が
- product を
文字列連結 で product とコード単位 0x0022（引用符）を連結した値に設定する。 - product を返す。
| コードポイント | Unicode 文字名 | エスケープシーケンス |
|---|---|---|
| U+0008 | バックスペース |
\b
|
| U+0009 | 水平タブ |
\t
|
| U+000A | ラインフィード (LF) |
\n
|
| U+000C | フォームフィード (FF) |
\f
|
| U+000D | キャリッジリターン (CR) |
\r
|
| U+0022 | 引用符 |
\"
|
| U+005C | 逆スラッシュ |
\\
|
25.5.2.4 UnicodeEscape ( C )
抽象操作 UnicodeEscape は、引数 C（コード単位）を取り、文字列を返します。C を Unicode エスケープシーケンスとして表現します。呼び出されたとき、以下の手順を実行します:
25.5.2.5 SerializeJSONObject ( state, value )
抽象操作 SerializeJSONObject は、引数 state（
- state.[[Stack]]がvalueを含む場合、構造が循環しているため
TypeError 例外を投げる。 - valueをstate.[[Stack]]に追加する。
- stepBack を state.[[Indent]] に設定する。
- state.[[Indent]] を
文字列連結 で state.[[Indent]] と state.[[Gap]] を連結した値に設定する。 - state.[[PropertyList]] が
undefined でない場合:- K を state.[[PropertyList]] に設定する。
- それ以外の場合:
- K を ?
EnumerableOwnProperties (value,key ) に設定する。
- K を ?
- partial を新しい空の
List に設定する。 - K の各要素 P について、以下を行う:
- strP を ?
SerializeJSONProperty (state, P, value) に設定する。 - strP が
undefined でない場合:- member を
QuoteJSONString (P) に設定する。 - member を
文字列連結 で member と":" を連結した値に設定する。 - state.[[Gap]] が空文字列でない場合:
- member を
文字列連結 で member とコード単位 0x0020（スペース）を連結した値に設定する。
- member を
- member を
文字列連結 で member と strP を連結した値に設定する。 - member を partial に追加する。
- member を
- strP を ?
- partial が空の場合:
- final を
"{}" に設定する。
- final を
- それ以外の場合:
- state.[[Gap]] が空文字列の場合:
- properties を partial の全要素文字列をコード単位 0x002C（カンマ）で隣接するペアごとに区切って連結した文字列値に設定する。カンマは最初の文字列の前や最後の文字列の後には挿入しない。
- final を
文字列連結 で"{" , properties,"}" を連結した値に設定する。
- それ以外の場合:
- separator をコード単位 0x002C（カンマ）、コード単位
0x000A（ラインフィード）、state.[[Indent]]
を
文字列連結 した値に設定する。 - properties を partial の全要素文字列を separator で隣接するペアごとに区切って連結した文字列値に設定する。separator は最初の文字列の前や最後の文字列の後には挿入しない。
- final を
文字列連結 で"{" , コード単位 0x000A（ラインフィード）、state.[[Indent]], properties, コード単位 0x000A（ラインフィード）、stepBack,"}" を連結した値に設定する。
- separator をコード単位 0x002C（カンマ）、コード単位
0x000A（ラインフィード）、state.[[Indent]]
を
- state.[[Gap]] が空文字列の場合:
- state.[[Stack]] の最後の要素を削除する。
- state.[[Indent]] を stepBack に設定する。
- final を返す。
25.5.2.6 SerializeJSONArray ( state, value )
抽象操作 SerializeJSONArray は、引数 state（
- state.[[Stack]] が value
を含む場合、構造が循環しているため
TypeError 例外を投げる。 - value を state.[[Stack]] に追加する。
- stepBack を state.[[Indent]] に設定する。
- state.[[Indent]] を
文字列連結 で state.[[Indent]] と state.[[Gap]] を連結した値に設定する。 - partial を新しい空の
List に設定する。 - len を ?
LengthOfArrayLike (value) に設定する。 - index を 0 に設定する。
- index < len の間、繰り返す:
- strP を ?
SerializeJSONProperty (state, !ToString (𝔽 (index)), value ) に設定する。 - strP が
undefined の場合:"null" を partial に追加する。
- それ以外の場合:
- strP を partial に追加する。
- index を index + 1 に設定する。
- strP を ?
- partial が空の場合:
- final を
"[]" に設定する。
- final を
- それ以外の場合:
- state.[[Gap]] が空文字列の場合:
- properties を partial の全要素文字列をコード単位 0x002C（カンマ）で隣接するペアごとに区切って連結した文字列値に設定する。カンマは最初の文字列の前や最後の文字列の後には挿入しない。
- final を
文字列連結 で"[" , properties,"]" を連結した値に設定する。
- それ以外の場合:
- separator をコード単位 0x002C（カンマ）、コード単位
0x000A（ラインフィード）、state.[[Indent]]
を
文字列連結 した値に設定する。 - properties を partial の全要素文字列を separator で隣接するペアごとに区切って連結した文字列値に設定する。separator は最初の文字列の前や最後の文字列の後には挿入しない。
- final を
文字列連結 で"[" , コード単位 0x000A（ラインフィード）、state.[[Indent]], properties, コード単位 0x000A（ラインフィード）、stepBack,"]" を連結した値に設定する。
- separator をコード単位 0x002C（カンマ）、コード単位
0x000A（ラインフィード）、state.[[Indent]]
を
- state.[[Gap]] が空文字列の場合:
- state.[[Stack]] の最後の要素を削除する。
- state.[[Indent]] を stepBack に設定する。
- final を返す。
25.5.3 JSON [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
26 メモリ管理
26.1 WeakRef オブジェクト
26.1.1 WeakRef コンストラクタ
WeakRef
- %WeakRef% です。
-
"WeakRef" プロパティの初期値としてグローバルオブジェクト に格納されます。 -
コンストラクタ として呼び出されたときに新しい WeakRef を生成し初期化します。 - 関数として呼び出すことは意図されておらず、そのように呼び出すと例外が投げられます。
-
クラス定義の
extends節の値として使用できます。指定されたWeakRefの動作を継承したいサブクラスのコンストラクタ は、superによるWeakRefコンストラクタ の呼び出しを含め、WeakRef.prototype組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを生成・初期化しなければなりません。
26.1.1.1 WeakRef ( target )
この関数は呼び出されたとき、以下の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外を投げる。 CanBeHeldWeakly (target) がfalse の場合、TypeError 例外を投げる。- weakRef を ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakRef.prototype%" , « [[WeakRefTarget]] ») に設定する。 AddToKeptObjects (target) を実行する。- weakRef.[[WeakRefTarget]] を target に設定する。
- weakRef を返す。
26.1.2 WeakRef コンストラクタのプロパティ
-
[[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 - 以下のプロパティを持ちます：
26.1.2.1 WeakRef.prototype
WeakRef.prototype の初期値は
このプロパティは属性 { [[Writable]]:
26.1.3 WeakRef プロトタイプオブジェクトのプロパティ
WeakRef プロトタイプオブジェクト：
- %WeakRef.prototype% です。
-
[[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。 通常のオブジェクト です。- [[WeakRefTarget]] 内部スロットは持ちません。
26.1.3.1 WeakRef.prototype.constructor
WeakRef.prototype.constructor の初期値は
26.1.3.2 WeakRef.prototype.deref ( )
このメソッドは呼び出されたとき、以下の手順を実行します：
- weakRef を
this の値に設定する。 - ?
RequireInternalSlot (weakRef, [[WeakRefTarget]]) を実行する。 WeakRefDeref (weakRef) を返す。
let target = { foo() {} };
let weakRef = new WeakRef(target);
// ... 後で ...
if (weakRef.deref()) {
weakRef.deref().foo();
}上記の例では、最初の deref が
26.1.3.3 WeakRef.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
26.1.4 WeakRef 抽象操作
26.1.4.1 WeakRefDeref ( weakRef )
抽象操作 WeakRefDeref は、引数 weakRef（
- target を weakRef.[[WeakRefTarget]] に設定する。
- target が
empty でない場合:AddToKeptObjects (target) を実行する。- target を返す。
undefined を返す。
この抽象操作は WeakRef.prototype.deref とは別に定義されており、ライブネスの定義を簡潔に記述できるようにしています。
26.1.5 WeakRef インスタンスのプロパティ
26.2 FinalizationRegistry オブジェクト
26.2.1 FinalizationRegistry コンストラクタ
FinalizationRegistry
- %FinalizationRegistry% です。
-
"FinalizationRegistry" プロパティの初期値としてグローバルオブジェクト に格納されます。 -
コンストラクタ として呼び出されたときに新しい FinalizationRegistry を生成し初期化します。 - 関数として呼び出すことは意図されておらず、そのように呼び出すと例外が投げられます。
-
クラス定義の
extends節の値として使用できます。指定されたFinalizationRegistryの動作を継承したいサブクラスのコンストラクタ は、superによるFinalizationRegistryコンストラクタ の呼び出しを含め、FinalizationRegistry.prototype組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを生成・初期化しなければなりません。
26.2.1.1 FinalizationRegistry ( cleanupCallback )
この関数は呼び出されたとき、以下の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外を投げる。 IsCallable (cleanupCallback) がfalse の場合、TypeError 例外を投げる。- finalizationRegistry を ?
OrdinaryCreateFromConstructor (NewTarget,"%FinalizationRegistry.prototype%" , « [[Realm]], [[CleanupCallback]], [[Cells]] ») に設定する。 - fn を
アクティブ関数オブジェクト に設定する。 - finalizationRegistry.[[Realm]] を fn.[[Realm]] に設定する。
- finalizationRegistry.[[CleanupCallback]] を
HostMakeJobCallback (cleanupCallback) に設定する。 - finalizationRegistry.[[Cells]] を新しい空の
List に設定する。 - finalizationRegistry を返す。
26.2.2 FinalizationRegistry コンストラクタのプロパティ
-
[[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 - 以下のプロパティを持ちます：
26.2.2.1 FinalizationRegistry.prototype
FinalizationRegistry.prototype の初期値は
このプロパティは属性 { [[Writable]]:
26.2.3 FinalizationRegistry プロトタイプオブジェクトのプロパティ
FinalizationRegistry プロトタイプオブジェクト：
- %FinalizationRegistry.prototype% です。
-
[[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。 通常のオブジェクト です。- [[Cells]] および [[CleanupCallback]] 内部スロットは持ちません。
26.2.3.1 FinalizationRegistry.prototype.constructor
FinalizationRegistry.prototype.constructor の初期値は
26.2.3.2 FinalizationRegistry.prototype.register ( target, heldValue [ , unregisterToken ] )
このメソッドは呼び出されたとき、以下の手順を実行します：
- finalizationRegistry を
this の値に設定する。 - ?
RequireInternalSlot (finalizationRegistry, [[Cells]]) を実行する。 CanBeHeldWeakly (target) がfalse の場合、TypeError 例外を投げる。SameValue (target, heldValue) がtrue の場合、TypeError 例外を投げる。CanBeHeldWeakly (unregisterToken) がfalse の場合:- unregisterToken が
undefined でない場合、TypeError 例外を投げる。 - unregisterToken を
empty に設定する。
- unregisterToken が
- cell を
Record { [[WeakRefTarget]]: target, [[HeldValue]]: heldValue, [[UnregisterToken]]: unregisterToken } に設定する。 - cell を finalizationRegistry.[[Cells]] に追加する。
undefined を返す。
26.2.3.3 FinalizationRegistry.prototype.unregister ( unregisterToken )
このメソッドは呼び出されたとき、以下の手順を実行します：
- finalizationRegistry を
this の値に設定する。 - ?
RequireInternalSlot (finalizationRegistry, [[Cells]]) を実行する。 CanBeHeldWeakly (unregisterToken) がfalse の場合、TypeError 例外を投げる。- removed を
false に設定する。 - finalizationRegistry.[[Cells]] の各
Record { [[WeakRefTarget]], [[HeldValue]], [[UnregisterToken]] } cell について、以下を行う:- cell.[[UnregisterToken]] が
empty でなく、SameValue (cell.[[UnregisterToken]], unregisterToken) がtrue の場合:- cell を finalizationRegistry.[[Cells]] から削除する。
- removed を
true に設定する。
- cell.[[UnregisterToken]] が
- removed を返す。
26.2.3.4 FinalizationRegistry.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
26.2.4 FinalizationRegistry インスタンスのプロパティ
27 制御抽象オブジェクト
27.1 反復処理
27.1.1 共通の反復インターフェース
インターフェースは、特定の仕様に一致する値を持つ
27.1.1.1 イテラブルインターフェース
イテラブルインターフェースには、
| プロパティ | 値 | 要件 |
|---|---|---|
%Symbol.iterator%
|
|
戻り値のオブジェクトは |
27.1.1.2 イテレーターインターフェース
イテレーターインターフェースを実装するオブジェクトは
| プロパティ | 値 | 要件 |
|---|---|---|
|
|
|
戻り値のオブジェクトはnextメソッドの以前の呼び出しがnextメソッドの呼び出しも |
next関数には引数を渡すことができますが、その解釈や妥当性は対象のイテレーターに依存します。for-of文やその他の一般的なイテレーター利用者は引数を渡さないため、そのような使い方を想定するイテレーターオブジェクトは引数なしで呼び出される場合にも対応できるようにする必要があります。
| プロパティ | 値 | 要件 |
|---|---|---|
|
|
|
戻り値のオブジェクトはnextメソッドを呼び出す意図がないことを通知します。返されるreturnメソッドの引数として渡された値が設定されます。ただし、この要件は強制されません。
|
|
|
|
戻り値のオブジェクトはthrowすることです。もしメソッドがthrowしなかった場合、返される |
これらのメソッドを呼び出す前に、存在確認を行うべきです。ECMAScriptの特定の言語機能（for-of、yield*、配列分割代入など）は、存在確認後にこれらのメソッドを呼び出します。
27.1.1.3 非同期イテラブルインターフェイス
非同期イテラブルインターフェイスには、
| プロパティ | 値 | 要件 |
|---|---|---|
%Symbol.asyncIterator% |
返されたオブジェクトは、 |
27.1.1.4 非同期イテレータインターフェイス
非同期イテレータインターフェイスを実装するオブジェクトは、
| プロパティ | 値 | 要件 |
|---|---|---|
|
返されたpromiseがfulfilledされた時、 さらに、fulfilled値となる |
next関数には引数を渡すことができますが、その解釈や妥当性は対象の非同期イテレータによって異なります。for-await-of文や他の一般的な非同期イテレータの利用者は、通常引数を渡しません。そのため、そのような使われ方を想定する非同期イテレータオブジェクトは、引数なしで呼び出された場合にも対応できるよう準備する必要があります。
| プロパティ | 値 | 要件 |
|---|---|---|
|
返されたpromiseがfulfilledされた時、 さらに、fulfilled値となる |
||
|
返されたpromiseがfulfilledされた時、 返されたpromiseがfulfilledされた場合、fulfilled値となる |
通常、これらのメソッドの呼び出し元は、呼び出す前に存在チェックを行うべきです。ECMAScriptの言語機能のうちfor-await-ofやyield*は、存在チェックをした上でこれらのメソッドを呼び出します。
27.1.1.5 IteratorResultインターフェイス
IteratorResultインターフェイスには、
| プロパティ | 値 | 要件 |
|---|---|---|
|
|
Boolean値 |
これはnextメソッド呼び出しの結果ステータスです。イテレータの終端に到達した場合、 |
|
|
|
doneが |
27.1.2 イテレータヘルパーオブジェクト
イテレータヘルパーオブジェクトは、
27.1.2.1 %IteratorHelperPrototype% オブジェクト
%IteratorHelperPrototype%オブジェクト:
イテレータヘルパーオブジェクト 全てが継承するプロパティを持っています。通常のオブジェクト です。- [[Prototype]]内部スロットの値は
%Iterator.prototype% です。 - 次のプロパティを持ちます:
27.1.2.1.1 %IteratorHelperPrototype%.next ( )
- Return ?
GeneratorResume (this value,undefined ,"Iterator Helper" ).
27.1.2.1.2 %IteratorHelperPrototype%.return ( )
- Oを
this の値とする。 - ?
RequireInternalSlot (O, [[UnderlyingIterator]])を行う。 アサート : Oは[[GeneratorState]]内部スロットを持つ。- もしO.[[GeneratorState]]が
suspended-start なら、- O.[[GeneratorState]]を
completed に設定する。 - 注: ジェネレーターがcompleted状態になると、二度とその状態から離れることはなく、関連する
実行コンテキスト は再開されません。この時点でOに関連する実行状態は破棄可能です。 - ?
IteratorClose (O.[[UnderlyingIterator]],NormalCompletion (unused ))を行う。 CreateIteratorResultObject (undefined ,true )を返す。
- O.[[GeneratorState]]を
- Cを
ReturnCompletion (undefined )とする。 - ?
GeneratorResumeAbrupt (O, C,"Iterator Helper" )を返す。
27.1.2.1.3 %IteratorHelperPrototype% [ %Symbol.toStringTag% ]
このプロパティは { [[Writable]]:
27.1.3 イテレータオブジェクト
27.1.3.1 イテレータコンストラクター
Iterator
- %Iterator%です。
グローバルオブジェクト の"Iterator" プロパティの初期値です。- サブクラス化可能な設計です。クラス定義の
extends 句の値として使用可能です。
27.1.3.1.1 Iterator ( )
この関数は呼び出されたとき、以下のステップを実行します:
- NewTargetが
undefined またはアクティブ関数オブジェクト の場合、TypeError 例外をthrowする。 - ?
OrdinaryCreateFromConstructor (NewTarget,"%Iterator.prototype%" )を返す。
27.1.3.2 イテレータコンストラクターのプロパティ
- [[Prototype]]内部スロットの値は
%Function.prototype% です。 - 次のプロパティを持ちます:
27.1.3.2.1 Iterator.from ( O )
- iteratorRecordを?
GetIteratorFlattenable (O,iterate-string-primitives )とする。 - hasInstanceを?
OrdinaryHasInstance (%Iterator% , iteratorRecord.[[Iterator]])とする。 - もしhasInstanceが
true なら、- iteratorRecord.[[Iterator]]を返す。
- wrapperを
OrdinaryObjectCreate (%WrapForValidIteratorPrototype% , « [[Iterated]] »)とする。 - wrapper.[[Iterated]]に iteratorRecordを設定する。
- wrapperを返す。
27.1.3.2.1.1 %WrapForValidIteratorPrototype% オブジェクト
%WrapForValidIteratorPrototype%オブジェクト:
通常のオブジェクト です。- [[Prototype]]内部スロットの値は
%Iterator.prototype% です。
27.1.3.2.1.1.1 %WrapForValidIteratorPrototype%.next ( )
- Oを
this の値とする。 - ?
RequireInternalSlot (O, [[Iterated]])を行う。 - iteratorRecordをO.[[Iterated]]とする。
- ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])を返す。
27.1.3.2.1.1.2 %WrapForValidIteratorPrototype%.return ( )
- Oを
this の値とする。 - ?
RequireInternalSlot (O, [[Iterated]])を行う。 - iteratorをO.[[Iterated]].[[Iterator]]とする。
アサート : iteratorはオブジェクトである 。- returnMethodを?
GetMethod (iterator,"return" )とする。 - もしreturnMethodが
undefined なら、CreateIteratorResultObject (undefined ,true )を返す。
- ?
Call (returnMethod, iterator)を返す。
27.1.3.2.2 Iterator.prototype
Iterator.prototypeの初期値は
このプロパティは { [[Writable]]:
27.1.4 イテレータプロトタイプオブジェクトのプロパティ
イテレータプロトタイプオブジェクト:
- %Iterator.prototype%です。
- [[Prototype]]内部スロットの値は
%Object.prototype% です。 通常のオブジェクト です。
この仕様で定義されるすべての
次の式は、ECMAScriptコードが%Iterator.prototype%オブジェクトにアクセスする一例です:
Object.getPrototypeOf(Object.getPrototypeOf([][Symbol.iterator]()))27.1.4.1 Iterator.prototype.constructor
Iterator.prototype.constructorは
27.1.4.1.1 get Iterator.prototype.constructor
[[Get]]属性の値は引数を必要としない組み込み関数です。呼び出されたとき、以下のステップを実行します:
%Iterator% を返す。
27.1.4.1.2 set Iterator.prototype.constructor
[[Set]]属性の値は引数vを取る組み込み関数です。呼び出されたとき、以下のステップを実行します:
- ?
SetterThatIgnoresPrototypeProperties (this value,%Iterator.prototype% ,"constructor" , v)を行う。 undefined を返す。
ほとんどの組み込みプロトタイプの
27.1.4.2 Iterator.prototype.drop ( limit )
このメソッドは呼び出されたとき、以下のステップを実行します:
- Oを
this の値とする。 - もしOが
オブジェクトでない 場合、TypeError 例外をthrowする。 - iteratedを
イテレータレコード {[[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }とする。 - numLimitを
Completion (ToNumber (limit))とする。 IfAbruptCloseIterator (numLimit, iterated)を行う。- もしnumLimitが
NaN なら、- errorを
ThrowCompletion (新たに生成されたRangeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- integerLimitを!
ToIntegerOrInfinity (numLimit)とする。 - もしintegerLimit < 0なら、
- errorを
ThrowCompletion (新たに生成されたRangeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを?
GetIteratorDirect (O)に設定する。 - closureを、新しい
抽象クロージャ （パラメータなし、iteratedとintegerLimitをキャプチャ）で、呼び出されたとき以下を実行するものとする:- remainingをintegerLimitとする。
- remaining > 0の間、繰り返す:
- もしremaining ≠ +∞なら、
- remainingをremaining - 1に設定する。
- nextを?
IteratorStep (iterated)とする。 - もしnextが
done なら、ReturnCompletion (undefined )を返す。
- もしremaining ≠ +∞なら、
- 繰り返す:
- valueを?
IteratorStepValue (iterated)とする。 - もしvalueが
done なら、ReturnCompletion (undefined )を返す。 - completionを
Completion (Yield (value))とする。 IfAbruptCloseIterator (completion, iterated)を行う。
- valueを?
- resultを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterator]] »)とする。 - result.[[UnderlyingIterator]]に iteratedを設定する。
- resultを返す。
27.1.4.3 Iterator.prototype.every ( predicate )
このメソッドは呼び出されたとき、以下のステップを実行します:
- Oを
this の値とする。 - もしOが
オブジェクトでない 場合、TypeError 例外をthrowする。 - iteratedを
イテレータレコード {[[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }とする。 - もし
IsCallable (predicate)がfalse なら、- errorを
ThrowCompletion (新たに生成されたTypeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを?
GetIteratorDirect (O)に設定する。 - counterを0とする。
- 繰り返す:
- valueを?
IteratorStepValue (iterated)とする。 - もしvalueが
done なら、true を返す。 - resultを
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (result, iterated)を行う。- もし
ToBoolean (result)がfalse なら、?IteratorClose (iterated,NormalCompletion (false ))を返す。 - counterをcounter + 1に設定する。
- valueを?
27.1.4.4 Iterator.prototype.filter ( predicate )
このメソッドは呼び出されたとき、以下のステップを実行します:
- Oを
this の値とする。 - もしOが
オブジェクトでない 場合、TypeError 例外をthrowする。 - iteratedを
イテレータレコード {[[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }とする。 - もし
IsCallable (predicate)がfalse なら、- errorを
ThrowCompletion (新たに生成されたTypeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを?
GetIteratorDirect (O)に設定する。 - closureを新しい
抽象クロージャ （パラメータなし、iteratedとpredicateをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- counterを0とする。
- 繰り返す:
- valueを?
IteratorStepValue (iterated)とする。 - もしvalueが
done なら、ReturnCompletion (undefined )を返す。 - selectedを
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (selected, iterated)を行う。- もし
ToBoolean (selected) がtrue なら、- completionを
Completion (Yield (value))とする。 IfAbruptCloseIterator (completion, iterated)を行う。
- completionを
- counterをcounter + 1に設定する。
- valueを?
- resultを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterator]] »)とする。 - result.[[UnderlyingIterator]]に iteratedを設定する。
- resultを返す。
27.1.4.5 Iterator.prototype.find ( predicate )
このメソッドは呼び出されたとき、以下のステップを実行します:
- Oを
this の値とする。 - もしOが
オブジェクトでない 場合、TypeError 例外をthrowする。 - iteratedを
イテレータレコード {[[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }とする。 - もし
IsCallable (predicate)がfalse なら、- errorを
ThrowCompletion (新たに生成されたTypeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを?
GetIteratorDirect (O)に設定する。 - counterを0とする。
- 繰り返す:
- valueを?
IteratorStepValue (iterated)とする。 - もしvalueが
done なら、undefined を返す。 - resultを
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (result, iterated)を行う。- もし
ToBoolean (result)がtrue なら、?IteratorClose (iterated,NormalCompletion (value))を返す。 - counterをcounter + 1に設定する。
- valueを?
27.1.4.6 Iterator.prototype.flatMap ( mapper )
このメソッドは呼び出されたとき、以下のステップを実行します:
- Oを
this の値とする。 - もしOが
オブジェクトでない 場合、TypeError 例外をthrowする。 - iteratedを
イテレータレコード {[[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }とする。 - もし
IsCallable (mapper)がfalse なら、- errorを
ThrowCompletion (新たに生成されたTypeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを?
GetIteratorDirect (O)に設定する。 - closureを新しい
抽象クロージャ （パラメータなし、iteratedとmapperをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- counterを0とする。
- 繰り返す:
- valueを?
IteratorStepValue (iterated)とする。 - もしvalueが
done なら、ReturnCompletion (undefined )を返す。 - mappedを
Completion (Call (mapper,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (mapped, iterated)を行う。- innerIteratorを
Completion (GetIteratorFlattenable (mapped,reject-primitives ))とする。 IfAbruptCloseIterator (innerIterator, iterated)を行う。- innerAliveを
true とする。 - innerAliveが
true の間、繰り返す:- innerValueを
Completion (IteratorStepValue (innerIterator))とする。 IfAbruptCloseIterator (innerValue, iterated)を行う。- もしinnerValueが
done なら、- innerAliveを
false に設定する。
- innerAliveを
- それ以外の場合、
- completionを
Completion (Yield (innerValue))とする。 - もしcompletionが
異常完了 なら、- backupCompletionを
Completion (IteratorClose (innerIterator, completion))とする。 IfAbruptCloseIterator (backupCompletion, iterated)を行う。- ?
IteratorClose (iterated, completion)を返す。
- backupCompletionを
- completionを
- innerValueを
- counterをcounter + 1に設定する。
- valueを?
- resultを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterator]] »)とする。 - result.[[UnderlyingIterator]]に iteratedを設定する。
- resultを返す。
27.1.4.7 Iterator.prototype.forEach ( procedure )
このメソッドは呼び出されたとき、以下のステップを実行します:
- Oを
this の値とする。 - もしOが
オブジェクトでない 場合、TypeError 例外をthrowする。 - iteratedを
イテレータレコード {[[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }とする。 - もし
IsCallable (procedure)がfalse なら、- errorを
ThrowCompletion (新たに生成されたTypeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを?
GetIteratorDirect (O)に設定する。 - counterを0とする。
- 繰り返す:
- valueを?
IteratorStepValue (iterated)とする。 - もしvalueが
done なら、undefined を返す。 - resultを
Completion (Call (procedure,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (result, iterated)を行う。- counterをcounter + 1に設定する。
- valueを?
27.1.4.8 Iterator.prototype.map ( mapper )
このメソッドは呼び出されたとき、以下のステップを実行します:
- Oを
this の値とする。 - もしOが
オブジェクトでない 場合、TypeError 例外をthrowする。 - iteratedを
イテレータレコード {[[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }とする。 - もし
IsCallable (mapper)がfalse なら、- errorを
ThrowCompletion (新たに生成されたTypeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを?
GetIteratorDirect (O)に設定する。 - closureを新しい
抽象クロージャ （パラメータなし、iteratedとmapperをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- counterを0とする。
- 繰り返す:
- valueを?
IteratorStepValue (iterated)とする。 - もしvalueが
done なら、ReturnCompletion (undefined )を返す。 - mappedを
Completion (Call (mapper,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (mapped, iterated)を行う。- completionを
Completion (Yield (mapped))とする。 IfAbruptCloseIterator (completion, iterated)を行う。- counterをcounter + 1に設定する。
- valueを?
- resultを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterator]] »)とする。 - result.[[UnderlyingIterator]]に iteratedを設定する。
- resultを返す。
27.1.4.9 Iterator.prototype.reduce ( reducer [ , initialValue ] )
このメソッドは呼び出されたとき、以下のステップを実行します:
- Oを
this の値とする。 - もしOが
オブジェクトでない 場合、TypeError 例外をthrowする。 - iteratedを
イテレータレコード {[[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }とする。 - もし
IsCallable (reducer)がfalse なら、- errorを
ThrowCompletion (新たに生成されたTypeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを?
GetIteratorDirect (O)に設定する。 - もしinitialValueが存在しない場合、
- accumulatorを?
IteratorStepValue (iterated)とする。 - もしaccumulatorが
done なら、TypeError 例外をthrowする。 - counterを1とする。
- accumulatorを?
- それ以外の場合、
- accumulatorをinitialValueとする。
- counterを0とする。
- 繰り返す:
- valueを?
IteratorStepValue (iterated)とする。 - もしvalueが
done なら、accumulatorを返す。 - resultを
Completion (Call (reducer,undefined , « accumulator, value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (result, iterated)を行う。- accumulatorをresultに設定する。
- counterをcounter + 1に設定する。
- valueを?
27.1.4.10 Iterator.prototype.some ( predicate )
このメソッドは呼び出されたとき、以下のステップを実行します:
- Oを
this の値とする。 - もしOが
オブジェクトでない 場合、TypeError 例外をthrowする。 - iteratedを
イテレータレコード {[[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }とする。 - もし
IsCallable (predicate)がfalse なら、- errorを
ThrowCompletion (新たに生成されたTypeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを?
GetIteratorDirect (O)に設定する。 - counterを0とする。
- 繰り返す:
- valueを?
IteratorStepValue (iterated)とする。 - もしvalueが
done なら、false を返す。 - resultを
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (result, iterated)を行う。- もし
ToBoolean (result)がtrue なら、?IteratorClose (iterated,NormalCompletion (true ))を返す。 - counterをcounter + 1に設定する。
- valueを?
27.1.4.11 Iterator.prototype.take ( limit )
このメソッドは呼び出されたとき、以下のステップを実行します:
- Oを
this の値とする。 - もしOが
オブジェクトでない 場合、TypeError 例外をthrowする。 - iteratedを
イテレータレコード {[[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }とする。 - numLimitを
Completion (ToNumber (limit))とする。 IfAbruptCloseIterator (numLimit, iterated)を行う。- もしnumLimitが
NaN なら、- errorを
ThrowCompletion (新たに生成されたRangeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- integerLimitを!
ToIntegerOrInfinity (numLimit)とする。 - もしintegerLimit < 0なら、
- errorを
ThrowCompletion (新たに生成されたRangeError オブジェクト)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを?
GetIteratorDirect (O)に設定する。 - closureを新しい
抽象クロージャ （パラメータなし、iteratedとintegerLimitをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- remainingをintegerLimitとする。
- 繰り返す:
- もしremaining = 0なら、
- ?
IteratorClose (iterated,ReturnCompletion (undefined ))を返す。
- ?
- もしremaining ≠ +∞なら、
- remainingをremaining - 1に設定する。
- valueを?
IteratorStepValue (iterated)とする。 - もしvalueが
done なら、ReturnCompletion (undefined )を返す。 - completionを
Completion (Yield (value))とする。 IfAbruptCloseIterator (completion, iterated)を行う。
- もしremaining = 0なら、
- resultを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterator]] »)とする。 - result.[[UnderlyingIterator]]に iteratedを設定する。
- resultを返す。
27.1.4.12 Iterator.prototype.toArray ( )
このメソッドは呼び出されたとき、以下のステップを実行します:
- Oを
this の値とする。 - もしOが
オブジェクトでない 場合、TypeError 例外をthrowする。 - iteratedを?
GetIteratorDirect (O)に設定する。 - itemsを新しい空の
List とする。 - 繰り返す:
- valueを?
IteratorStepValue (iterated)とする。 - もしvalueが
done なら、CreateArrayFromList (items)を返す。 - valueをitemsに追加する。
- valueを?
27.1.4.13 Iterator.prototype [ %Symbol.iterator% ] ( )
この関数は呼び出されたとき、以下のステップを実行します:
this の値を返す。
この関数の
27.1.4.14 Iterator.prototype [ %Symbol.toStringTag% ]
Iterator.prototype[%Symbol.toStringTag%]は
27.1.4.14.1 get Iterator.prototype [ %Symbol.toStringTag% ]
[[Get]]属性の値は引数を必要としない組み込み関数です。呼び出されたとき、以下のステップを実行します:
"Iterator" を返す。
27.1.4.14.2 set Iterator.prototype [ %Symbol.toStringTag% ]
[[Set]]属性の値は引数vを取る組み込み関数です。呼び出されたとき、以下のステップを実行します:
- ?
SetterThatIgnoresPrototypeProperties (this value,%Iterator.prototype% ,%Symbol.toStringTag% , v)を行う。 undefined を返す。
ほとんどの組み込みプロトタイプの
27.1.5 %AsyncIteratorPrototype% オブジェクト
%AsyncIteratorPrototype%オブジェクト:
- [[Prototype]]内部スロットの値は
%Object.prototype% です。 通常のオブジェクト です。
この仕様で定義されるすべての
27.1.5.1 %AsyncIteratorPrototype% [ %Symbol.asyncIterator% ] ( )
この関数は呼び出されたとき、以下のステップを実行します:
this の値を返す。
この関数の
27.1.6 非同期-同期変換イテレータオブジェクト
非同期-同期変換イテレータオブジェクトは、特定の同期
27.1.6.1 CreateAsyncFromSyncIterator ( syncIteratorRecord )
抽象操作CreateAsyncFromSyncIteratorはsyncIteratorRecord（
- asyncIteratorを
OrdinaryObjectCreate (%AsyncFromSyncIteratorPrototype% , « [[SyncIteratorRecord]] »)とする。 - asyncIterator.[[SyncIteratorRecord]]にsyncIteratorRecordを設定する。
- nextMethodを!
Get (asyncIterator,"next" )とする。 - iteratorRecordを
イテレータレコード {[[Iterator]]: asyncIterator, [[NextMethod]]: nextMethod, [[Done]]:false }とする。 - iteratorRecordを返す。
27.1.6.2 %AsyncFromSyncIteratorPrototype% オブジェクト
%AsyncFromSyncIteratorPrototype%オブジェクト:
非同期-同期変換イテレータオブジェクト すべてが継承するプロパティを持っています。通常のオブジェクト です。- [[Prototype]]内部スロットの値は
%AsyncIteratorPrototype% です。 - ECMAScriptコードから直接アクセスされることはありません。
- 次のプロパティを持ちます:
27.1.6.2.1 %AsyncFromSyncIteratorPrototype%.next ( [ value ] )
- Oを
this の値とする。 アサート : Oはオブジェクト であり、[[SyncIteratorRecord]]内部スロットを持つ。- promiseCapabilityを!
NewPromiseCapability (%Promise% )とする。 - syncIteratorRecordをO.[[SyncIteratorRecord]]とする。
- もしvalueが存在するなら、
- resultを
Completion (IteratorNext (syncIteratorRecord, value))とする。
- resultを
- それ以外の場合、
- resultを
Completion (IteratorNext (syncIteratorRecord))とする。
- resultを
IfAbruptRejectPromise (result, promiseCapability)を行う。AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true )を返す。
27.1.6.2.2 %AsyncFromSyncIteratorPrototype%.return ( [ value ] )
- Oを
this の値とする。 アサート : Oはオブジェクト であり、[[SyncIteratorRecord]]内部スロットを持つ。- promiseCapabilityを!
NewPromiseCapability (%Promise% )とする。 - syncIteratorRecordをO.[[SyncIteratorRecord]]とする。
- syncIteratorをsyncIteratorRecord.[[Iterator]]とする。
- returnを
Completion (GetMethod (syncIterator,"return" ))とする。 IfAbruptRejectPromise (return, promiseCapability)を行う。- もしreturnが
undefined なら、- iteratorResultを
CreateIteratorResultObject (value,true )とする。 - ! Call(promiseCapability.[[Resolve]],
undefined , « iteratorResult »)を実行する。 - promiseCapability.[[Promise]]を返す。
- iteratorResultを
- もしvalueが存在するなら、
- resultを
Completion (Call (return, syncIterator, « value »))とする。
- resultを
- それ以外の場合、
- resultを
Completion (Call (return, syncIterator))とする。
- resultを
IfAbruptRejectPromise (result, promiseCapability)を行う。- もしresultが
オブジェクトでない なら、- !
Call (promiseCapability.[[Reject]],undefined , « 新たに生成されたTypeError オブジェクト »)を実行する。 - promiseCapability.[[Promise]]を返す。
- !
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,false )を返す。
27.1.6.2.3 %AsyncFromSyncIteratorPrototype%.throw ( [ value ] )
- Oを
this の値とする。 アサート : Oはオブジェクト であり、[[SyncIteratorRecord]]内部スロットを持つ。- promiseCapabilityを!
NewPromiseCapability (%Promise% )とする。 - syncIteratorRecordをO.[[SyncIteratorRecord]]とする。
- syncIteratorをsyncIteratorRecord.[[Iterator]]とする。
- throwを
Completion (GetMethod (syncIterator,"throw" ))とする。 IfAbruptRejectPromise (throw, promiseCapability)を行う。- もしthrowが
undefined なら、- 注:
syncIteratorが
throwメソッドを持たない場合、クローズ処理を行い、その後capabilityをrejectします。 - closeCompletionを
NormalCompletion (empty )とする。 - resultを
Completion (IteratorClose (syncIteratorRecord, closeCompletion))とする。 IfAbruptRejectPromise (result, promiseCapability)を行う。- 注:
次のステップはプロトコル違反（syncIteratorが
throwメソッドを持たない）であることを示すTypeErrorをthrowします。 - 注: クローズ処理が例外を投げなかった場合、その結果は無視され、rejectされたpromiseでも無視されます。
- !
Call (promiseCapability.[[Reject]],undefined , « 新たに生成されたTypeError オブジェクト »)を実行する。 - promiseCapability.[[Promise]]を返す。
- 注:
syncIteratorが
- もしvalueが存在するなら、
- resultを
Completion (Call (throw, syncIterator, « value »))とする。
- resultを
- それ以外の場合、
- resultを
Completion (Call (throw, syncIterator))とする。
- resultを
IfAbruptRejectPromise (result, promiseCapability)を行う。- もしresultが
オブジェクトでない なら、- !
Call (promiseCapability.[[Reject]],undefined , « 新たに生成されたTypeError オブジェクト »)を実行する。 - promiseCapability.[[Promise]]を返す。
- !
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true )を返す。
27.1.6.3 非同期-同期変換イテレータインスタンスのプロパティ
非同期-同期変換
27.1.6.4 AsyncFromSyncIteratorContinuation ( result, promiseCapability, syncIteratorRecord, closeOnRejection )
抽象操作AsyncFromSyncIteratorContinuationはresult（オブジェクト）、promiseCapability（組み込み
- 注: promiseCapabilityは組み込み
%Promise% から生成されるため、以下で使われるIfAbruptRejectPromise によるpromiseCapability.[[Reject]]の呼び出しは、例外を投げることはありません。 - doneを
Completion (IteratorComplete (result))とする。 IfAbruptRejectPromise (done, promiseCapability)を行う。- valueを
Completion (IteratorValue (result))とする。 IfAbruptRejectPromise (value, promiseCapability)を行う。- valueWrapperを
Completion (PromiseResolve (%Promise% , value))とする。 - もしvalueWrapperが
異常完了 で、doneがfalse 、closeOnRejectionがtrue なら、- valueWrapperを
Completion (IteratorClose (syncIteratorRecord, valueWrapper))に設定する。
- valueWrapperを
IfAbruptRejectPromise (valueWrapper, promiseCapability)を行う。- unwrapを新しい
抽象クロージャ （引数(v)、doneをキャプチャ）とし、呼び出されたとき以下を実行するものとする:CreateIteratorResultObject (v, done)を返す。
- onFulfilledを
CreateBuiltinFunction (unwrap, 1,"" , « »)とする。 - 注: onFulfilledは、
IteratorResultオブジェクト の"value" プロパティがpromiseの場合にその値を待ち、新たな「アンラップされた」IteratorResultオブジェクト として結果を再パッケージするために使用されます。 - もしdoneが
true 、またはcloseOnRejectionがfalse なら、- onRejectedを
undefined とする。
- onRejectedを
- それ以外の場合、
- closeIteratorを新しい
抽象クロージャ （引数(error)、syncIteratorRecordをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- ?
IteratorClose (syncIteratorRecord,ThrowCompletion (error))を返す。
- ?
- onRejectedを
CreateBuiltinFunction (closeIterator, 1,"" , « »)とする。 - 注: onRejectedは、
イテレータ のIteratorResultオブジェクト がrejectされたpromiseの場合に、イテレータをクローズするために使用されます。
- closeIteratorを新しい
PerformPromiseThen (valueWrapper, onFulfilled, onRejected, promiseCapability)を実行する。- promiseCapability.[[Promise]]を返す。
27.2 Promiseオブジェクト
Promiseは、遅延（かつ非同期の場合もある）計算の最終的な結果を保持するために使われるオブジェクトです。
Promiseは、fulfilled（履行済み）、rejected（拒否済み）、pending（保留中）の3つの排他的な状態のいずれかです。
-
Promise
pがfulfilledの場合、p.then(f, r)は関数fを呼び出すジョブ を即座にキューに入れます。 -
Promise
pがrejectedの場合、p.then(f, r)は関数rを呼び出すジョブ を即座にキューに入れます。 - Promiseがpendingの場合、それはfulfilledでもrejectedでもありません。
Promiseがsettled（確定済み）とされるのはpendingでない場合、すなわちfulfilledまたはrejectedの場合です。
Promiseがresolved（解決済み）とされるのは、settledであるか、他のPromiseの状態に「ロック」された場合です。解決済みのPromiseをresolveまたはrejectしようとしても効果はありません。Promiseがunresolved（未解決）であれば、resolvedではありません。未解決のPromiseは常にpending状態です。解決済みのPromiseはpending、fulfilled、rejectedのいずれかである可能性があります。
27.2.1 Promise抽象操作
27.2.1.1 PromiseCapabilityレコード
PromiseCapabilityレコードは、PromiseまたはPromiseのようなオブジェクトと、そのPromiseをresolveまたはrejectできる関数をカプセル化するために使用される
PromiseCapabilityレコードは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Promise]] | オブジェクト | Promiseとして利用可能なオブジェクト。 |
| [[Resolve]] |
|
該当Promiseをresolveするために使用される関数。 |
| [[Reject]] |
|
該当Promiseをrejectするために使用される関数。 |
27.2.1.1.1 IfAbruptRejectPromise ( value, capability )
IfAbruptRejectPromiseは、
IfAbruptRejectPromise (value, capability)。
は、次の意味になります:
アサート : valueはCompletionレコード である。- もしvalueが
異常完了 なら、- ?
Call (capability.[[Reject]],undefined , « value.[[Value]] »)を実行する。 - capability.[[Promise]]を返す。
- ?
- それ以外の場合:
- valueに! valueを設定する。
27.2.1.2 PromiseReactionレコード
PromiseReactionレコードは、Promiseが特定の値で解決または拒否された際にどのように反応するべきかの情報を保持するために使用される
PromiseReactionレコードは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Capability]] |
|
このレコードがリアクションハンドラを提供するPromiseの能力 |
| [[Type]] |
|
[[Handler]]が |
| [[Handler]] |
|
入力値に適用され、戻り値が派生Promiseに対する動作を決定する関数。[[Handler]]が |
27.2.1.3 CreateResolvingFunctions ( promise )
抽象操作CreateResolvingFunctionsは、引数promise（Promise）を受け取り、フィールド[[Resolve]]（
- alreadyResolvedを
レコード { [[Value]]:false }とする。 - stepsResolveを
Promise Resolve Functions で定義されているアルゴリズムステップとする。 - lengthResolveを
Promise Resolve Functions の関数定義の非オプションパラメータ数とする。 - resolveを
CreateBuiltinFunction (stepsResolve, lengthResolve,"" , « [[Promise]], [[AlreadyResolved]] »)とする。 - resolve.[[Promise]]にpromiseを設定する。
- resolve.[[AlreadyResolved]]にalreadyResolvedを設定する。
- stepsRejectを
Promise Reject Functions で定義されているアルゴリズムステップとする。 - lengthRejectを
Promise Reject Functions の関数定義の非オプションパラメータ数とする。 - rejectを
CreateBuiltinFunction (stepsReject, lengthReject,"" , « [[Promise]], [[AlreadyResolved]] »)とする。 - reject.[[Promise]]にpromiseを設定する。
- reject.[[AlreadyResolved]]にalreadyResolvedを設定する。
レコード { [[Resolve]]: resolve, [[Reject]]: reject }を返す。
27.2.1.3.1 Promise Reject Functions
Promise reject functionは、[[Promise]]および[[AlreadyResolved]]内部スロットを持つ匿名の組み込み関数です。
Promise reject functionが引数reasonで呼び出された場合、以下のステップを実行します:
- Fを
アクティブ関数オブジェクト とする。 アサート : Fは値がオブジェクト である[[Promise]]内部スロットを持つ。- promiseをF.[[Promise]]とする。
- alreadyResolvedをF.[[AlreadyResolved]]とする。
- もしalreadyResolved.[[Value]]が
true なら、undefined を返す。 - alreadyResolved.[[Value]]を
true に設定する。 RejectPromise (promise, reason)を実行する。undefined を返す。
Promise reject
functionの
27.2.1.3.2 Promise Resolve Functions
Promise resolve functionは、[[Promise]]および[[AlreadyResolved]]内部スロットを持つ匿名の組み込み関数です。
Promise resolve functionが引数resolutionで呼び出された場合、以下のステップを実行します:
- Fを
アクティブ関数オブジェクト とする。 アサート : Fは値がオブジェクト である[[Promise]]内部スロットを持つ。- promiseをF.[[Promise]]とする。
- alreadyResolvedをF.[[AlreadyResolved]]とする。
- もしalreadyResolved.[[Value]]が
true なら、undefined を返す。 - alreadyResolved.[[Value]]を
true に設定する。 - もし
SameValue (resolution, promise)がtrue なら、- selfResolutionErrorを新たに生成された
TypeError オブジェクトとする。 RejectPromise (promise, selfResolutionError)を実行する。undefined を返す。
- selfResolutionErrorを新たに生成された
- もしresolutionが
オブジェクトでない なら、FulfillPromise (promise, resolution)を実行する。undefined を返す。
- thenを
Completion (Get (resolution,"then" ))とする。 - もしthenが
異常完了 なら、RejectPromise (promise, then.[[Value]])を実行する。undefined を返す。
- thenActionをthen.[[Value]]とする。
- もし
IsCallable (thenAction) がfalse なら、FulfillPromise (promise, resolution)を実行する。undefined を返す。
- thenJobCallbackを
HostMakeJobCallback (thenAction)とする。 - jobを
NewPromiseResolveThenableJob (promise, resolution, thenJobCallback)とする。 HostEnqueuePromiseJob (job.[[Job]], job.[[Realm]])を実行する。undefined を返す。
Promise resolve
functionの
27.2.1.4 FulfillPromise ( promise, value )
抽象操作FulfillPromiseは、引数promise（Promise）とvalue（
アサート : promise.[[PromiseState]]はpending である。- reactionsをpromise.[[PromiseFulfillReactions]]とする。
- promise.[[PromiseResult]]に valueを設定する。
- promise.[[PromiseFulfillReactions]]に
undefined を設定する。 - promise.[[PromiseRejectReactions]]に
undefined を設定する。 - promise.[[PromiseState]]に
fulfilled を設定する。 TriggerPromiseReactions (reactions, value)を実行する。unused を返す。
27.2.1.5 NewPromiseCapability ( C )
抽象操作NewPromiseCapabilityは、引数C（resolveとreject関数を抽出します。Promiseとresolve/reject関数を使って新しい
- もし
IsConstructor (C)がfalse なら、TypeError 例外をthrowする。 - 注: CはPromise
コンストラクター （27.2.3.1 参照）のパラメータ規約をサポートするものと仮定します。 - resolvingFunctionsを
レコード { [[Resolve]]:undefined , [[Reject]]:undefined }とする。 - executorClosureを新しい
抽象クロージャ （引数(resolve, reject)、resolvingFunctionsをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- もしresolvingFunctions.[[Resolve]]が
undefined でなければ、TypeError 例外をthrowする。 - もしresolvingFunctions.[[Reject]]が
undefined でなければ、TypeError 例外をthrowする。 - resolvingFunctions.[[Resolve]]にresolveを設定する。
- resolvingFunctions.[[Reject]]にrejectを設定する。
NormalCompletion (undefined )を返す。
- もしresolvingFunctions.[[Resolve]]が
- executorを
CreateBuiltinFunction (executorClosure, 2,"" , « »)とする。 - promiseを?
Construct (C, « executor »)とする。 - もし
IsCallable (resolvingFunctions.[[Resolve]])がfalse なら、TypeError 例外をthrowする。 - もし
IsCallable (resolvingFunctions.[[Reject]])がfalse なら、TypeError 例外をthrowする。 PromiseCapabilityレコード { [[Promise]]: promise, [[Resolve]]: resolvingFunctions.[[Resolve]], [[Reject]]: resolvingFunctions.[[Reject]] }を返す。
27.2.1.6 IsPromise ( x )
抽象操作IsPromiseは、引数x（
- もしxが
オブジェクトでない 場合、false を返す。 - もしxが[[PromiseState]]内部スロットを持たなければ、
false を返す。 true を返す。
27.2.1.7 RejectPromise ( promise, reason )
抽象操作RejectPromiseは、引数promise（Promise）とreason（
アサート : promise.[[PromiseState]]はpending である。- reactionsをpromise.[[PromiseRejectReactions]]とする。
- promise.[[PromiseResult]]に reasonを設定する。
- promise.[[PromiseFulfillReactions]]に
undefined を設定する。 - promise.[[PromiseRejectReactions]]に
undefined を設定する。 - promise.[[PromiseState]]に
rejected を設定する。 - もしpromise.[[PromiseIsHandled]]が
false なら、HostPromiseRejectionTracker (promise,"reject" )を実行する。 TriggerPromiseReactions (reactions, reason)を実行する。unused を返す。
27.2.1.8 TriggerPromiseReactions ( reactions, argument )
抽象操作TriggerPromiseReactionsは、引数reactions（
- reactionsの各要素reactionについて、以下を行う:
- jobを
NewPromiseReactionJob (reaction, argument)とする。 HostEnqueuePromiseJob (job.[[Job]], job.[[Realm]])を実行する。
- jobを
unused を返す。
27.2.1.9 HostPromiseRejectionTracker ( promise, operation )
HostPromiseRejectionTrackerのデフォルト実装は
HostPromiseRejectionTrackerは次の2つの場面で呼び出されます:
- Promiseがハンドラなしで拒否されたとき、operation引数が
"reject" に設定されて呼び出されます。 - 拒否済みPromiseに初めてハンドラが追加されたとき、operation引数が
"handle" に設定されて呼び出されます。
HostPromiseRejectionTrackerの一般的な実装は、未処理の拒否を開発者に通知しようとする一方、後で新しいハンドラが追加されて通知が無効化された場合にも注意深く通知することがあります。
operationが
27.2.2 Promiseジョブ
27.2.2.1 NewPromiseReactionJob ( reaction, argument )
抽象操作NewPromiseReactionJobは、引数reaction（
- jobを新しい
ジョブ 抽象クロージャ （パラメータなし、reactionとargumentをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- promiseCapabilityをreaction.[[Capability]]とする。
- typeをreaction.[[Type]]とする。
- handlerをreaction.[[Handler]]とする。
- もしhandlerが
empty なら、- もしtypeが
fulfill なら、- handlerResultを
NormalCompletion (argument)とする。
- handlerResultを
- それ以外の場合:
アサート : typeはreject である。- handlerResultを
ThrowCompletion (argument)とする。
- もしtypeが
- それ以外の場合:
- handlerResultを
Completion (HostCallJobCallback (handler,undefined , « argument »))とする。
- handlerResultを
- もしpromiseCapabilityが
undefined なら、 アサート : promiseCapability はPromiseCapabilityレコード である。- もしhandlerResultが
異常完了 なら、- ?
Call (promiseCapability.[[Reject]],undefined , « handlerResult.[[Value]] »)を返す。
- ?
- それ以外の場合:
- ?
Call (promiseCapability.[[Resolve]],undefined , « handlerResult.[[Value]] »)を返す。
- ?
- handlerRealmを
null とする。 - もしreaction.[[Handler]]が
empty でないなら、- getHandlerRealmResultを
Completion (GetFunctionRealm (reaction.[[Handler]].[[Callback]]))とする。 - もしgetHandlerRealmResultが
正常完了 なら、handlerRealmを getHandlerRealmResult.[[Value]]に設定する。 - それ以外の場合、handlerRealmを
現在のRealmレコード に設定する。 - 注:
handlerRealmはハンドラが
undefined でない限りnull になりません。ハンドラが破棄されたProxyでECMAScriptコードが実行されない場合、handlerRealmはエラーオブジェクトの生成に使われます。
- getHandlerRealmResultを
レコード { [[Job]]: job, [[Realm]]: handlerRealm }を返す。
27.2.2.2 NewPromiseResolveThenableJob ( promiseToResolve, thenable, then )
抽象操作NewPromiseResolveThenableJobは、引数promiseToResolve（Promise）、thenable（オブジェクト）、then（
- jobを新しい
ジョブ 抽象クロージャ （パラメータなし、promiseToResolve, thenable, thenをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- resolvingFunctionsを
CreateResolvingFunctions (promiseToResolve)とする。 - thenCallResultを
Completion (HostCallJobCallback (then, thenable, « resolvingFunctions.[[Resolve]], resolvingFunctions.[[Reject]] »))とする。 - もしthenCallResultが
異常完了 なら、- ?
Call (resolvingFunctions.[[Reject]],undefined , « thenCallResult.[[Value]] »)を返す。
- ?
- ! thenCallResultを返す。
- resolvingFunctionsを
- getThenRealmResultを
Completion (GetFunctionRealm (then.[[Callback]]))とする。 - もしgetThenRealmResultが
正常完了 なら、thenRealmを getThenRealmResult.[[Value]]に設定する。 - それ以外の場合、thenRealmを
現在のRealmレコード に設定する。 - 注: thenRealmは
null になることはありません。then.[[Callback]]が破棄されたProxyでコードが実行されない場合、thenRealmはエラーオブジェクトの生成に使われます。 レコード { [[Job]]: job, [[Realm]]: thenRealm }を返す。
27.2.3 Promise コンストラクター
Promise
- %Promise%である。
グローバルオブジェクト の"Promise" プロパティの初期値である。コンストラクター として呼び出されたとき、新しいPromiseを作成・初期化する。- 関数として呼び出すことを意図しておらず、その場合は例外を投げる。
- クラス定義の
extends句の値として使用することができる。Promiseの動作を継承しようとするサブクラスコンストラクター は、組み込みのPromiseおよびPromise.prototypeのメソッドを利用するために必要な内部状態でサブクラスインスタンスを作成・初期化するため、Promiseコンストラクター へのsuper呼び出しを含めなければならない。
27.2.3.1 Promise ( executor )
この関数は呼び出されたとき、以下のステップを実行します:
- NewTargetが
undefined なら、TypeError 例外をthrowする。 IsCallable (executor)がfalse なら、TypeError 例外をthrowする。- promiseを?
OrdinaryCreateFromConstructor (NewTarget,"%Promise.prototype%" , « [[PromiseState]], [[PromiseResult]], [[PromiseFulfillReactions]], [[PromiseRejectReactions]], [[PromiseIsHandled]] »)とする。 - promise.[[PromiseState]]に
pending を設定する。 - promise.[[PromiseResult]]に
empty を設定する。 - promise.[[PromiseFulfillReactions]]に新しい空の
List を設定する。 - promise.[[PromiseRejectReactions]]に新しい空の
List を設定する。 - promise.[[PromiseIsHandled]]に
false を設定する。 - resolvingFunctionsを
CreateResolvingFunctions (promise)とする。 - completionを
Completion (Call (executor,undefined , « resolvingFunctions.[[Resolve]], resolvingFunctions.[[Reject]] »))とする。 - もしcompletionが
異常完了 なら、- ?
Call (resolvingFunctions.[[Reject]],undefined , « completion.[[Value]] »)を実行する。
- ?
- promiseを返す。
executor引数は
executor関数に渡されるresolve関数は1つの引数を取ります。executorのコードは最終的にresolve関数を呼び出して、関連付けられたPromiseを解決したいことを示すことができます。resolve関数に渡される引数は遅延処理の最終的な値を表し、実際の履行値またはfulfilled時に値を提供する他のPromiseのどちらかです。
executor関数に渡されるreject関数も1つの引数を取ります。executorのコードは最終的にreject関数を呼び出して、関連付けられたPromiseが拒否され履行されないことを示すことができます。reject関数に渡される引数はPromiseの拒否値として使われ、通常はErrorオブジェクトです。
Promise
27.2.4 Promiseコンストラクターのプロパティ
Promise
- [[Prototype]]内部スロットの値は
%Function.prototype% である。 - 次のプロパティを持つ:
27.2.4.1 Promise.all ( iterable )
この関数は、渡されたpromiseの履行値を配列としてfulfillされる新しいpromiseを返します。また、最初にrejectされたpromiseの理由でrejectされます。アルゴリズムの実行中、渡された
- Cを
this の値とする。 - promiseCapabilityを?
NewPromiseCapability (C)とする。 - promiseResolveを
Completion (GetPromiseResolve (C))とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability)を行う。- iteratorRecordを
Completion (GetIterator (iterable,sync ))とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)を行う。- resultを
Completion (PerformPromiseAll (iteratorRecord, C, promiseCapability, promiseResolve))とする。 - もしresultが
異常完了 なら、- もしiteratorRecord.[[Done]]が
false なら、resultをCompletion (IteratorClose (iteratorRecord, result))に設定する。 IfAbruptRejectPromise (result, promiseCapability)を行う。
- もしiteratorRecord.[[Done]]が
- ! resultを返す。
27.2.4.1.1 GetPromiseResolve ( promiseConstructor )
抽象操作GetPromiseResolveは、引数promiseConstructor（
- promiseResolveを?
Get (promiseConstructor,"resolve" )とする。 IsCallable (promiseResolve) がfalse なら、TypeError 例外をthrowする。- promiseResolveを返す。
27.2.4.1.2 PerformPromiseAll ( iteratorRecord, constructor, resultCapability, promiseResolve )
抽象操作PerformPromiseAllは、引数iteratorRecord（
- valuesを新しい空の
List とする。 - remainingElementsCountを
レコード { [[Value]]: 1 }とする。 - indexを0とする。
- 繰り返す:
- nextを?
IteratorStepValue (iteratorRecord)とする。 - もしnextが
done なら、- remainingElementsCount.[[Value]]を remainingElementsCount.[[Value]] - 1に設定する。
- もしremainingElementsCount.[[Value]] = 0なら、
- valuesArrayを
CreateArrayFromList (values)とする。 - ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)を実行する。
- valuesArrayを
- resultCapability.[[Promise]]を返す。
undefined をvaluesに追加する。- nextPromiseを?
Call (promiseResolve, constructor, « next »)とする。 - stepsを
Promise.allResolve Element Functions - lengthを
Promise.allResolve Element Functions - onFulfilledを
CreateBuiltinFunction (steps, length,"" , « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »)とする。 - onFulfilled.[[AlreadyCalled]]に
false を設定する。 - onFulfilled.[[Index]]に indexを設定する。
- onFulfilled.[[Values]]に valuesを設定する。
- onFulfilled.[[Capability]]に resultCapabilityを設定する。
- onFulfilled.[[RemainingElements]]に remainingElementsCountを設定する。
- remainingElementsCount.[[Value]]を remainingElementsCount.[[Value]] + 1に設定する。
- ?
Invoke (nextPromise,"then" , « onFulfilled, resultCapability.[[Reject]] »)を実行する。 - indexをindex + 1に設定する。
- nextを?
27.2.4.1.3 Promise.all 解決要素関数
Promise.all解決要素関数は、特定のPromise.all要素を解決するために使われる匿名の組み込み関数です。各Promise.all解決要素関数は、[[Index]]、[[Values]]、[[Capability]]、[[RemainingElements]]、および[[AlreadyCalled]]内部スロットを持ちます。
Promise.all解決要素関数が引数xで呼び出された場合、以下のステップを実行します:
- Fを
アクティブ関数オブジェクト とする。 - もしF.[[AlreadyCalled]]が
true なら、undefined を返す。 - F.[[AlreadyCalled]]に
true を設定する。 - indexをF.[[Index]]とする。
- valuesをF.[[Values]]とする。
- promiseCapabilityをF.[[Capability]]とする。
- remainingElementsCountをF.[[RemainingElements]]とする。
- values[index]にxを設定する。
- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] - 1に設定する。
- もしremainingElementsCount.[[Value]] = 0なら、
- valuesArrayを
CreateArrayFromList (values)とする。 - ?
Call (promiseCapability.[[Resolve]],undefined , « valuesArray »)を返す。
- valuesArrayを
undefined を返す。
Promise.all解決要素関数の
27.2.4.2 Promise.allSettled ( iterable )
この関数は、渡されたpromiseがすべてsettled（fulfilledまたはrejected）になった後に、promiseの状態スナップショットの配列でfulfillされるpromiseを返します。アルゴリズムの実行中、渡された
- Cを
this の値とする。 - promiseCapabilityを?
NewPromiseCapability (C)とする。 - promiseResolveを
Completion (GetPromiseResolve (C))とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability)を行う。- iteratorRecordを
Completion (GetIterator (iterable,sync ))とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)を行う。- resultを
Completion (PerformPromiseAllSettled (iteratorRecord, C, promiseCapability, promiseResolve))とする。 - もしresultが
異常完了 なら、- もしiteratorRecord.[[Done]]が
false なら、resultをCompletion (IteratorClose (iteratorRecord, result))に設定する。 IfAbruptRejectPromise (result, promiseCapability)を行う。
- もしiteratorRecord.[[Done]]が
- ! resultを返す。
27.2.4.2.1 PerformPromiseAllSettled ( iteratorRecord, constructor, resultCapability, promiseResolve )
抽象操作PerformPromiseAllSettledは、引数iteratorRecord（
- valuesを新しい空の
List とする。 - remainingElementsCountを
レコード { [[Value]]: 1 }とする。 - indexを0とする。
- 繰り返す:
- nextを?
IteratorStepValue (iteratorRecord)とする。 - もしnextが
done なら、- remainingElementsCount.[[Value]]を remainingElementsCount.[[Value]] - 1に設定する。
- もしremainingElementsCount.[[Value]] = 0なら、
- valuesArrayを
CreateArrayFromList (values)とする。 - ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)を実行する。
- valuesArrayを
- resultCapability.[[Promise]]を返す。
undefined をvaluesに追加する。- nextPromiseを?
Call (promiseResolve, constructor, « next »)とする。 - stepsFulfilledを
Promise.allSettledResolve Element Functions - lengthFulfilledを
Promise.allSettledResolve Element Functions - onFulfilledを
CreateBuiltinFunction (stepsFulfilled, lengthFulfilled,"" , « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »)とする。 - alreadyCalledを
レコード { [[Value]]:false }とする。 - onFulfilled.[[AlreadyCalled]]に alreadyCalledを設定する。
- onFulfilled.[[Index]]に indexを設定する。
- onFulfilled.[[Values]]に valuesを設定する。
- onFulfilled.[[Capability]]に resultCapabilityを設定する。
- onFulfilled.[[RemainingElements]]に remainingElementsCountを設定する。
- stepsRejectedを
Promise.allSettledReject Element Functions - lengthRejectedを
Promise.allSettledReject Element Functions - onRejectedを
CreateBuiltinFunction (stepsRejected, lengthRejected,"" , « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »)とする。 - onRejected.[[AlreadyCalled]]に alreadyCalledを設定する。
- onRejected.[[Index]]に indexを設定する。
- onRejected.[[Values]]に valuesを設定する。
- onRejected.[[Capability]]に resultCapabilityを設定する。
- onRejected.[[RemainingElements]] にremainingElementsCountを設定する。
- remainingElementsCount.[[Value]] をremainingElementsCount.[[Value]] + 1に設定する。
- ?
Invoke (nextPromise,"then" , « onFulfilled, onRejected »)を実行する。 - indexをindex + 1に設定する。
- nextを?
27.2.4.2.2 Promise.allSettled 解決要素関数
Promise.allSettled解決要素関数は、特定のPromise.allSettled要素を解決するために使われる匿名の組み込み関数です。各Promise.allSettled解決要素関数は、[[Index]]、[[Values]]、[[Capability]]、[[RemainingElements]]、および[[AlreadyCalled]]内部スロットを持ちます。
Promise.allSettled解決要素関数が引数xで呼び出された場合、以下のステップを実行します:
- Fを
アクティブ関数オブジェクト とする。 - alreadyCalledをF.[[AlreadyCalled]]とする。
- もしalreadyCalled.[[Value]]が
true なら、undefined を返す。 - alreadyCalled.[[Value]]に
true を設定する。 - indexをF.[[Index]]とする。
- valuesをF.[[Values]]とする。
- promiseCapabilityをF.[[Capability]]とする。
- remainingElementsCountをF.[[RemainingElements]]とする。
- objを
OrdinaryObjectCreate (%Object.prototype% )とする。 - !
CreateDataPropertyOrThrow (obj,"status" ,"fulfilled" )を実行する。 - !
CreateDataPropertyOrThrow (obj,"value" , x)を実行する。 - values[index]にobjを設定する。
- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] - 1に設定する。
- もしremainingElementsCount.[[Value]] = 0なら、
- valuesArrayを
CreateArrayFromList (values)とする。 - ?
Call (promiseCapability.[[Resolve]],undefined , « valuesArray »)を返す。
- valuesArrayを
undefined を返す。
Promise.allSettled解決要素関数の
27.2.4.2.3 Promise.allSettled 拒否要素関数
Promise.allSettled拒否要素関数は、特定のPromise.allSettled要素を拒否するために使われる匿名の組み込み関数です。各Promise.allSettled拒否要素関数は、[[Index]]、[[Values]]、[[Capability]]、[[RemainingElements]]、および[[AlreadyCalled]]内部スロットを持ちます。
Promise.allSettled拒否要素関数が引数xで呼び出された場合、以下のステップを実行します:
- Fを
アクティブ関数オブジェクト とする。 - alreadyCalledをF.[[AlreadyCalled]]とする。
- もしalreadyCalled.[[Value]]が
true なら、undefined を返す。 - alreadyCalled.[[Value]]に
true を設定する。 - indexをF.[[Index]]とする。
- valuesをF.[[Values]]とする。
- promiseCapabilityをF.[[Capability]]とする。
- remainingElementsCountをF.[[RemainingElements]]とする。
- objを
OrdinaryObjectCreate (%Object.prototype% )とする。 - !
CreateDataPropertyOrThrow (obj,"status" ,"rejected" )を実行する。 - !
CreateDataPropertyOrThrow (obj,"reason" , x)を実行する。 - values[index]にobjを設定する。
- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] - 1に設定する。
- もしremainingElementsCount.[[Value]] = 0なら、
- valuesArrayを
CreateArrayFromList (values)とする。 - ?
Call (promiseCapability.[[Resolve]],undefined , « valuesArray »)を返す。
- valuesArrayを
undefined を返す。
Promise.allSettled拒否要素関数の
27.2.4.3 Promise.any ( iterable )
この関数は、渡されたpromiseのうち最初にfulfillされたものによってfulfillされるpromiseを返します。すべてのpromiseがrejectされた場合は、reject理由を保持するAggregateErrorでrejectされます。アルゴリズムの実行中、渡された
- Cを
this の値とする。 - promiseCapabilityを?
NewPromiseCapability (C)とする。 - promiseResolveを
Completion (GetPromiseResolve (C))とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability)を行う。- iteratorRecordを
Completion (GetIterator (iterable,sync ))とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)を行う。- resultを
Completion (PerformPromiseAny (iteratorRecord, C, promiseCapability, promiseResolve))とする。 - もしresultが
異常完了 なら、- もしiteratorRecord.[[Done]]が
false なら、resultをCompletion (IteratorClose (iteratorRecord, result))に設定する。 IfAbruptRejectPromise (result, promiseCapability)を行う。
- もしiteratorRecord.[[Done]]が
- ! resultを返す。
27.2.4.3.1 PerformPromiseAny ( iteratorRecord, constructor, resultCapability, promiseResolve )
抽象操作PerformPromiseAnyは、引数iteratorRecord（
- errorsを新しい空の
List とする。 - remainingElementsCountを
レコード { [[Value]]: 1 }とする。 - indexを0とする。
- 繰り返す:
- nextを?
IteratorStepValue (iteratorRecord)とする。 - もしnextが
done なら、- remainingElementsCount.[[Value]]を remainingElementsCount.[[Value]] - 1に設定する。
- もしremainingElementsCount.[[Value]] = 0なら、
- errorを新たに生成された
AggregateError オブジェクトとする。 - !
DefinePropertyOrThrow (error,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) } )を実行する。 ThrowCompletion (error)を返す。
- errorを新たに生成された
- resultCapability.[[Promise]]を返す。
undefined をerrorsに追加する。- nextPromiseを?
Call (promiseResolve, constructor, « next »)とする。 - stepsRejectedを
Promise.anyReject Element Functions - lengthRejectedを
Promise.anyReject Element Functions - onRejectedを
CreateBuiltinFunction (stepsRejected, lengthRejected,"" , « [[AlreadyCalled]], [[Index]], [[Errors]], [[Capability]], [[RemainingElements]] »)とする。 - onRejected.[[AlreadyCalled]]に
false を設定する。 - onRejected.[[Index]]に indexを設定する。
- onRejected.[[Errors]]に errorsを設定する。
- onRejected.[[Capability]]に resultCapabilityを設定する。
- onRejected.[[RemainingElements]] にremainingElementsCountを設定する。
- remainingElementsCount.[[Value]] をremainingElementsCount.[[Value]] + 1に設定する。
- ?
Invoke (nextPromise,"then" , « resultCapability.[[Resolve]], onRejected »)を実行する。 - indexをindex + 1に設定する。
- nextを?
27.2.4.3.2 Promise.any 拒否要素関数
Promise.any拒否要素関数は、特定のPromise.any要素を拒否するために使われる匿名の組み込み関数です。各Promise.any拒否要素関数は[[Index]]、[[Errors]]、[[Capability]]、[[RemainingElements]]、[[AlreadyCalled]]内部スロットを持ちます。
Promise.any拒否要素関数が引数xで呼び出された場合、以下のステップを実行します:
- Fを
アクティブ関数オブジェクト とする。 - もしF.[[AlreadyCalled]]が
true なら、undefined を返す。 - F.[[AlreadyCalled]]に
true を設定する。 - indexをF.[[Index]]とする。
- errorsをF.[[Errors]]とする。
- promiseCapabilityをF.[[Capability]]とする。
- remainingElementsCountをF.[[RemainingElements]]とする。
- errors[index]にxを設定する。
- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] - 1に設定する。
- もしremainingElementsCount.[[Value]] = 0なら、
- errorを新たに生成された
AggregateError オブジェクトとする。 - !
DefinePropertyOrThrow (error,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) } )を実行する。 - ?
Call (promiseCapability.[[Reject]],undefined , « error »)を返す。
- errorを新たに生成された
undefined を返す。
Promise.any拒否要素関数の
27.2.4.4 Promise.prototype
Promise.prototypeの初期値は、
このプロパティの属性は { [[Writable]]:
27.2.4.5 Promise.race ( iterable )
この関数は、最初にsettleしたpromiseと同じようにsettleされる新しいpromiseを返します。アルゴリズムの実行中、渡されたiterableのすべての要素をpromiseに解決します。
- Cを
this の値とする。 - promiseCapabilityを?
NewPromiseCapability (C)とする。 - promiseResolveを
Completion (GetPromiseResolve (C))とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability)を行う。- iteratorRecordを
Completion (GetIterator (iterable,sync ))とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)を行う。- resultを
Completion (PerformPromiseRace (iteratorRecord, C, promiseCapability, promiseResolve))とする。 - もしresultが
異常完了 なら、- もしiteratorRecord.[[Done]]が
false なら、resultをCompletion (IteratorClose (iteratorRecord, result))に設定する。 IfAbruptRejectPromise (result, promiseCapability)を行う。
- もしiteratorRecord.[[Done]]が
- ! resultを返す。
もしiterable引数が値を返さない場合や、iterableから得られたpromiseのどれも決着しない場合、このメソッドが返す保留中のpromiseは決着しません。
27.2.4.5.1 PerformPromiseRace ( iteratorRecord, constructor, resultCapability, promiseResolve )
抽象操作PerformPromiseRaceは、引数iteratorRecord（
- 繰り返す:
- nextを?
IteratorStepValue (iteratorRecord)とする。 - もしnextが
done なら、- resultCapability.[[Promise]]を返す。
- nextPromiseを?
Call (promiseResolve, constructor, « next »)とする。 - ?
Invoke (nextPromise,"then" , « resultCapability.[[Resolve]], resultCapability.[[Reject]] »)を実行する。
- nextを?
27.2.4.6 Promise.reject ( r )
この関数は、渡された引数でrejectされた新しいpromiseを返します。
- Cを
this の値とする。 - promiseCapabilityを?
NewPromiseCapability (C)とする。 - ?
Call (promiseCapability.[[Reject]],undefined , « r »)を実行する。 - promiseCapability.[[Promise]]を返す。
27.2.4.7 Promise.resolve ( x )
この関数は、渡された引数でresolveされた新しいpromise、または引数がこの
- Cを
this の値とする。 - もしCが
オブジェクトでない なら、TypeError 例外をthrowする。 - ?
PromiseResolve (C, x)を返す。
27.2.4.7.1 PromiseResolve ( C, x )
抽象操作PromiseResolveは、引数C（オブジェクト）とx（
- もし
IsPromise (x)がtrue なら、 - promiseCapabilityを?
NewPromiseCapability (C)とする。 - ?
Call (promiseCapability.[[Resolve]],undefined , « x »)を実行する。 - promiseCapability.[[Promise]]を返す。
27.2.4.8 Promise.try ( callback, ...args )
この関数は呼び出されたとき、以下のステップを実行します:
- Cを
this の値とする。 - もしCが
オブジェクトでない なら、TypeError 例外をthrowする。 - promiseCapabilityを?
NewPromiseCapability (C)とする。 - statusを
Completion (Call (callback,undefined , args))とする。 - もしstatusが
異常完了 なら、- ?
Call (promiseCapability.[[Reject]],undefined , « status.[[Value]] »)を実行する。
- ?
- それ以外の場合:
- ?
Call (promiseCapability.[[Resolve]],undefined , « status.[[Value]] »)を実行する。
- ?
- promiseCapability.[[Promise]]を返す。
27.2.4.9 Promise.withResolvers ( )
この関数は、新しいpromiseとそれに関連付けられたresolve関数およびreject関数をプロパティとして持つオブジェクトを返します。
- Cを
this の値とする。 - promiseCapabilityを?
NewPromiseCapability (C)とする。 - objを
OrdinaryObjectCreate (%Object.prototype% )とする。 - !
CreateDataPropertyOrThrow (obj,"promise" , promiseCapability.[[Promise]])を実行する。 - !
CreateDataPropertyOrThrow (obj,"resolve" , promiseCapability.[[Resolve]])を実行する。 - !
CreateDataPropertyOrThrow (obj,"reject" , promiseCapability.[[Reject]])を実行する。 - objを返す。
27.2.4.10 get Promise [ %Symbol.species% ]
Promise[%Symbol.species%]は
this の値を返す。
この関数の
Promiseプロトタイプメソッドは通常
27.2.5 Promiseプロトタイプオブジェクトのプロパティ
Promiseプロトタイプオブジェクト:
- %Promise.prototype%である。
- [[Prototype]]内部スロットの値は
%Object.prototype% である。 通常のオブジェクト である。- [[PromiseState]]内部スロットやPromiseインスタンスのその他の内部スロットは持たない。
27.2.5.1 Promise.prototype.catch ( onRejected )
このメソッドは呼び出されたとき、以下のステップを実行します:
- promiseを
this の値とする。 - ?
Invoke (promise,"then" , «undefined , onRejected »)を返す。
27.2.5.2 Promise.prototype.constructor
Promise.prototype.constructorの初期値は
27.2.5.3 Promise.prototype.finally ( onFinally )
このメソッドは呼び出されたとき、以下のステップを実行します:
- promiseを
this の値とする。 - もしpromiseが
オブジェクトでない なら、TypeError 例外をthrowする。 - Cを?
SpeciesConstructor (promise,%Promise% )とする。 Assert :IsConstructor (C)はtrue である。- もし
IsCallable (onFinally)がfalse なら、- thenFinallyをonFinallyとする。
- catchFinallyをonFinallyとする。
- それ以外の場合:
- thenFinallyClosureを新しい
抽象クロージャ （パラメータ(value), onFinallyとCをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- resultを?
Call (onFinally,undefined )とする。 - pを?
PromiseResolve (C, result)とする。 - returnValueを新しい
抽象クロージャ （パラメータなし、valueをキャプチャ）とし、呼び出されたとき以下を実行するものとする:NormalCompletion (value)を返す。
- valueThunkを
CreateBuiltinFunction (returnValue, 0,"" , « »)とする。 - ?
Invoke (p,"then" , « valueThunk »)を返す。
- resultを?
- thenFinallyを
CreateBuiltinFunction (thenFinallyClosure, 1,"" , « »)とする。 - catchFinallyClosureを新しい
抽象クロージャ （パラメータ(reason), onFinallyとCをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- resultを?
Call (onFinally,undefined )とする。 - pを?
PromiseResolve (C, result)とする。 - throwReasonを新しい
抽象クロージャ （パラメータなし、reasonをキャプチャ）とし、呼び出されたとき以下を実行するものとする:ThrowCompletion (reason)を返す。
- throwerを
CreateBuiltinFunction (throwReason, 0,"" , « »)とする。 - ?
Invoke (p,"then" , « thrower »)を返す。
- resultを?
- catchFinallyを
CreateBuiltinFunction (catchFinallyClosure, 1,"" , « »)とする。
- thenFinallyClosureを新しい
- ?
Invoke (promise,"then" , « thenFinally, catchFinally »)を返す。
27.2.5.4 Promise.prototype.then ( onFulfilled, onRejected )
このメソッドは呼び出されたとき、以下のステップを実行します:
- promiseを
this の値とする。 - もし
IsPromise (promise)がfalse なら、TypeError 例外をthrowする。 - Cを?
SpeciesConstructor (promise,%Promise% )とする。 - resultCapabilityを?
NewPromiseCapability (C)とする。 PerformPromiseThen (promise, onFulfilled, onRejected, resultCapability)を返す。
27.2.5.4.1 PerformPromiseThen ( promise, onFulfilled, onRejected [ , resultCapability ] )
抽象操作PerformPromiseThenは、引数promise（Promise）、onFulfilled（
Assert :IsPromise (promise)はtrue である。- もしresultCapabilityが存在しない場合:
- resultCapabilityを
undefined に設定する。
- resultCapabilityを
- もし
IsCallable (onFulfilled) がfalse なら:- onFulfilledJobCallbackを
empty とする。
- onFulfilledJobCallbackを
- それ以外の場合:
- onFulfilledJobCallbackを
HostMakeJobCallback (onFulfilled)とする。
- onFulfilledJobCallbackを
- もし
IsCallable (onRejected) がfalse なら:- onRejectedJobCallbackを
empty とする。
- onRejectedJobCallbackを
- それ以外の場合:
- onRejectedJobCallbackを
HostMakeJobCallback (onRejected)とする。
- onRejectedJobCallbackを
- fulfillReactionを
PromiseReactionレコード { [[Capability]]: resultCapability, [[Type]]:fulfill , [[Handler]]: onFulfilledJobCallback }とする。 - rejectReactionを
PromiseReactionレコード { [[Capability]]: resultCapability, [[Type]]:reject , [[Handler]]: onRejectedJobCallback }とする。 - もしpromise.[[PromiseState]]が
pending なら:- fulfillReactionをpromise.[[PromiseFulfillReactions]]に追加する。
- rejectReactionをpromise.[[PromiseRejectReactions]]に追加する。
- それ以外のとき、promise.[[PromiseState]]が
fulfilled なら:- valueをpromise.[[PromiseResult]]とする。
- fulfillJobを
NewPromiseReactionJob (fulfillReaction, value)とする。 HostEnqueuePromiseJob (fulfillJob.[[Job]], fulfillJob.[[Realm]])を実行する。
- それ以外の場合:
Assert : promise.[[PromiseState]]はrejected である。- reasonをpromise.[[PromiseResult]]とする。
- もしpromise.[[PromiseIsHandled]]が
false なら、HostPromiseRejectionTracker (promise,"handle" )を実行する。 - rejectJobを
NewPromiseReactionJob (rejectReaction, reason)とする。 HostEnqueuePromiseJob (rejectJob.[[Job]], rejectJob.[[Realm]])を実行する。
- promise.[[PromiseIsHandled]]に
true を設定する。 - もしresultCapabilityが
undefined なら:undefined を返す。
- それ以外の場合:
- resultCapability.[[Promise]]を返す。
27.2.5.5 Promise.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
27.2.6 Promiseインスタンスのプロパティ
Promiseインスタンスは
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[PromiseState]] |
|
promiseがthenメソッドへの呼び出しにどのように反応するかを管理します。
|
| [[PromiseResult]] |
|
promiseがfulfillまたはrejectされた値（あれば）。[[PromiseState]]が |
| [[PromiseFulfillReactions]] |
|
promiseが |
| [[PromiseRejectReactions]] |
|
promiseが |
| [[PromiseIsHandled]] | ブール値 | promiseがfulfillmentまたはrejectionハンドラを持ったことがあるかどうかを示します。未処理拒否の追跡に使用されます。 |
27.3 GeneratorFunctionオブジェクト
GeneratorFunctionは、通常
27.3.1 GeneratorFunctionコンストラクター
GeneratorFunction
- %GeneratorFunction%である。
Functionのサブクラスである。コンストラクター としてではなく関数として呼び出された場合、新しいGeneratorFunctionを生成し初期化する。したがって、関数呼び出しGeneratorFunction (…)は、同じ引数によるnew GeneratorFunction (…)のオブジェクト生成式と等価である。- クラス定義の
extends句の値として使用することができる。指定されたGeneratorFunctionの動作を継承するサブクラスコンストラクター は、組み込みのGeneratorFunctionの動作に必要な内部スロットでサブクラスインスタンスを生成・初期化するため、GeneratorFunctionコンストラクター へのsuper呼び出しを含める必要がある。ジェネレーター関数オブジェクト を定義するすべてのECMAScript構文形式は、GeneratorFunctionの直接インスタンスを生成する。GeneratorFunctionサブクラスのインスタンスを生成する構文手段は存在しない。
27.3.1.1 GeneratorFunction ( ...parameterArgs, bodyArg )
最後の引数（ある場合）は、ジェネレーター関数の本体（実行コード）を指定し、それ以前の引数は仮引数を指定します。
この関数は呼び出されたとき、以下のステップを実行します:
- Cを
アクティブ関数オブジェクト とする。 - もしbodyArgが存在しない場合、bodyArgを空文字列に設定する。
- ?
CreateDynamicFunction (C, NewTarget,generator , parameterArgs, bodyArg)を返す。
27.3.2 GeneratorFunctionコンストラクターのプロパティ
GeneratorFunction
- 標準の組み込み
関数オブジェクト で、Functionコンストラクター から継承する。 - [[Prototype]]内部スロットの値は
%Function% である。 "length" プロパティの値は1 𝔽である。"name" プロパティの値は"GeneratorFunction" である。- 以下のプロパティを持つ：
27.3.2.1 GeneratorFunction.prototype
GeneratorFunction.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
27.3.3 GeneratorFunctionプロトタイプオブジェクトのプロパティ
GeneratorFunctionプロトタイプオブジェクト:
- %GeneratorFunction.prototype%である（
図6 参照）。 通常のオブジェクト である。関数オブジェクト ではなく、[[ECMAScriptCode]]内部スロットや、表30 または表93 に記載されている他の内部スロットを持たない。- [[Prototype]]内部スロットの値は
%Function.prototype% である。
27.3.3.1 GeneratorFunction.prototype.constructor
GeneratorFunction.prototype.constructorの初期値は
このプロパティの属性は { [[Writable]]:
27.3.3.2 GeneratorFunction.prototype.prototype
GeneratorFunction.prototype.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
27.3.3.3 GeneratorFunction.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
27.3.4 GeneratorFunctionインスタンス
すべてのGeneratorFunctionインスタンスはECMAScriptの
各GeneratorFunctionインスタンスは以下の独自プロパティを持ちます:
27.3.4.1 length
27.3.4.2 name
27.3.4.3 prototype
GeneratorFunctionインスタンスが生成されるたびに、別の
このプロパティの属性は { [[Writable]]:
Functionインスタンスとは異なり、GeneratorFunctionの
27.4 AsyncGeneratorFunctionオブジェクト
AsyncGeneratorFunctionは、通常
27.4.1 AsyncGeneratorFunctionコンストラクター
AsyncGeneratorFunction
- %AsyncGeneratorFunction%である。
Functionのサブクラスである。- コンストラクターとしてではなく関数として呼び出された場合、新しいAsyncGeneratorFunctionを生成し初期化する。したがって、関数呼び出し
AsyncGeneratorFunction (...)は、同じ引数によるnew AsyncGeneratorFunction (...)のオブジェクト生成式と等価である。 - クラス定義の
extends句の値として使用することができる。指定されたAsyncGeneratorFunctionの動作を継承するサブクラスコンストラクター は、組み込みのAsyncGeneratorFunctionの動作に必要な内部スロットでサブクラスインスタンスを生成・初期化するため、AsyncGeneratorFunctionコンストラクター へのsuper呼び出しを含める必要がある。async generator関数オブジェクト を定義するすべてのECMAScript構文形式は、AsyncGeneratorFunctionの直接インスタンスを生成する。AsyncGeneratorFunctionサブクラスのインスタンスを生成する構文手段は存在しない。
27.4.1.1 AsyncGeneratorFunction ( ...parameterArgs, bodyArg )
最後の引数（ある場合）は、async generator関数の本体（実行コード）を指定し、それ以前の引数は仮引数を指定します。
この関数は呼び出されたとき、以下のステップを実行します:
- Cを
アクティブ関数オブジェクト とする。 - もしbodyArgが存在しない場合、bodyArgを空文字列に設定する。
- ?
CreateDynamicFunction (C, NewTarget,async-generator , parameterArgs, bodyArg)を返す。
27.4.2 AsyncGeneratorFunctionコンストラクターのプロパティ
AsyncGeneratorFunction
- 標準の組み込み
関数オブジェクト で、Functionコンストラクター から継承する。 - [[Prototype]]内部スロットの値は
%Function% である。 "length" プロパティの値は1 𝔽である。"name" プロパティの値は"AsyncGeneratorFunction" である。- 以下のプロパティを持つ：
27.4.2.1 AsyncGeneratorFunction.prototype
AsyncGeneratorFunction.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
27.4.3 AsyncGeneratorFunctionプロトタイプオブジェクトのプロパティ
AsyncGeneratorFunctionプロトタイプオブジェクト:
- %AsyncGeneratorFunction.prototype%である。
通常のオブジェクト である。関数オブジェクト ではなく、[[ECMAScriptCode]]内部スロットや、表30 または表94 に記載されている他の内部スロットを持たない。- [[Prototype]]内部スロットの値は
%Function.prototype% である。
27.4.3.1 AsyncGeneratorFunction.prototype.constructor
AsyncGeneratorFunction.prototype.constructorの初期値は
このプロパティの属性は { [[Writable]]:
27.4.3.2 AsyncGeneratorFunction.prototype.prototype
AsyncGeneratorFunction.prototype.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
27.4.3.3 AsyncGeneratorFunction.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
27.4.4 AsyncGeneratorFunctionインスタンス
すべてのAsyncGeneratorFunctionインスタンスはECMAScriptの
各AsyncGeneratorFunctionインスタンスは以下の独自プロパティを持ちます:
27.4.4.1 length
このプロパティの属性は { [[Writable]]:
27.4.4.2 name
27.4.4.3 prototype
AsyncGeneratorFunctionインスタンスが生成されるたびに、別の
このプロパティの属性は { [[Writable]]:
Functionインスタンスとは異なり、AsyncGeneratorFunctionの
27.5 ジェネレーターオブジェクト
ジェネレーターはジェネレーター関数を呼び出すことで作成され、
ジェネレーターインスタンスは、インスタンスを生成したジェネレーター関数の
27.5.1 %GeneratorPrototype% オブジェクト
%GeneratorPrototype%オブジェクト：
- %GeneratorFunction.prototype.prototype%である。
通常のオブジェクト である。- ジェネレーターインスタンスではなく、[[GeneratorState]]内部スロットを持たない。
- [[Prototype]]内部スロットの値は
%Iterator.prototype% である。 - すべてのジェネレーターインスタンスが間接的に継承するプロパティを持つ。
27.5.1.1 %GeneratorPrototype%.constructor
.constructorの初期値は
このプロパティの属性は { [[Writable]]:
27.5.1.2 %GeneratorPrototype%.next ( value )
- ?
GeneratorResume (this の値, value,empty )を返す。
27.5.1.3 %GeneratorPrototype%.return ( value )
このメソッドは呼び出されたとき、以下のステップを実行します:
- gを
this の値とする。 - Cを
ReturnCompletion (value)とする。 - ?
GeneratorResumeAbrupt (g, C,empty )を返す。
27.5.1.4 %GeneratorPrototype%.throw ( exception )
このメソッドは呼び出されたとき、以下のステップを実行します:
- gを
this の値とする。 - Cを
ThrowCompletion (exception)とする。 - ?
GeneratorResumeAbrupt (g, C,empty )を返す。
27.5.1.5 %GeneratorPrototype% [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
27.5.2 ジェネレーターインスタンスのプロパティ
ジェネレーターインスタンスは、
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[GeneratorState]] |
|
ジェネレーターの現在の実行状態。 |
| [[GeneratorContext]] |
|
このジェネレーターのコードを実行する際に使用される |
| [[GeneratorBrand]] |
文字列または |
異なる種類のジェネレーターを区別するためのブランド。 |
27.5.3 ジェネレーター抽象操作
27.5.3.1 GeneratorStart ( generator, generatorBody )
抽象操作GeneratorStartは、引数generator（ジェネレーター）とgeneratorBody（
Assert : generator.[[GeneratorState]]はsuspended-start である。- genContextを
実行中の実行コンテキスト とする。 - genContextのGenerator成分をgeneratorに設定する。
- closureをパラメータなしでgeneratorBodyをキャプチャする新しい
抽象クロージャ とし、呼び出されたとき以下のステップを実行する:- acGenContextを
実行中の実行コンテキスト とする。 - acGeneratorをacGenContextのGenerator成分とする。
- もしgeneratorBodyが
構文ノード なら:- resultを
Completion (Evaluation of generatorBody)とする。
- resultを
- それ以外の場合:
Assert : generatorBodyはパラメータなしの抽象クロージャ である。- resultを
Completion (generatorBody())とする。
Assert : ここでreturnした場合、ジェネレーターは例外を投げたか、暗黙的または明示的なreturnを行った。- acGenContextを
実行コンテキストスタック から削除し、実行コンテキスト スタックのトップにある実行コンテキストスタック を実行中の実行コンテキスト として復元する。 - acGenerator.[[GeneratorState]]を
completed に設定する。 - 注: ジェネレーターが
completed 状態になったら二度と抜け出さず、対応する実行コンテキスト は再開されない。この時点でacGeneratorに関連付けられた実行状態は破棄できる。 - もしresultが
正常完了 なら:- resultValueを
undefined とする。
- resultValueを
- それ以外の場合resultが
return完了 なら:- resultValueをresult.[[Value]]とする。
- それ以外の場合:
NormalCompletion (CreateIteratorResultObject (resultValue,true ))を返す。
- acGenContextを
- genContextのコード評価状態を、その
実行コンテキスト の評価が再開されたときclosureが引数なしで呼び出されるように設定する。 - generator.[[GeneratorContext]]にgenContextを設定する。
unused を返す。
27.5.3.2 GeneratorValidate ( generator, generatorBrand )
抽象操作GeneratorValidateは、引数generator（
- ?
RequireInternalSlot (generator, [[GeneratorState]])を実行する。 - ?
RequireInternalSlot (generator, [[GeneratorBrand]])を実行する。 - もしgenerator.[[GeneratorBrand]]がgeneratorBrandでないなら、
TypeError 例外をthrowする。 Assert : generatorは[[GeneratorContext]]内部スロットも持つ。- stateをgenerator.[[GeneratorState]]とする。
- もしstateが
executing なら、TypeError 例外をthrowする。 - stateを返す。
27.5.3.3 GeneratorResume ( generator, value, generatorBrand )
抽象操作GeneratorResumeは、引数generator（
- stateを?
GeneratorValidate (generator, generatorBrand)とする。 - もしstateが
completed なら、CreateIteratorResultObject (undefined ,true )を返す。 Assert : stateはsuspended-start またはsuspended-yield である。- genContextをgenerator.[[GeneratorContext]]とする。
- methodContextを
実行中の実行コンテキスト とする。 - methodContextをサスペンドする。
- generator.[[GeneratorState]]を
executing に設定する。 - genContextを
実行コンテキストスタック にプッシュする；genContextは現在の実行中の実行コンテキスト となる。 - genContextのサスペンドされた評価を再開する。その際、サスペンド操作の結果として
NormalCompletion (value)を渡す。resultを再開された計算が返す値とする。 Assert : ここでreturnした時点で、genContextは実行コンテキストスタック から既に除去されており、methodContextが現在の実行中の実行コンテキスト である。- ? resultを返す。
27.5.3.4 GeneratorResumeAbrupt ( generator, abruptCompletion, generatorBrand )
抽象操作GeneratorResumeAbruptは、引数generator（
- stateを?
GeneratorValidate (generator, generatorBrand)とする。 - もしstateが
suspended-start なら:- generator.[[GeneratorState]]を
completed に設定する。 - 注: ジェネレーターが
completed 状態になったら二度と抜け出さず、対応する実行コンテキスト は再開されない。この時点でgeneratorに関連付けられた実行状態は破棄できる。 - stateを
completed に設定する。
- generator.[[GeneratorState]]を
- もしstateが
completed なら:- もしabruptCompletionが
return完了 なら:CreateIteratorResultObject (abruptCompletion.[[Value]],true )を返す。
- ? abruptCompletionを返す。
- もしabruptCompletionが
Assert : stateはsuspended-yield である。- genContextをgenerator.[[GeneratorContext]]とする。
- methodContextを
実行中の実行コンテキスト とする。 - methodContextをサスペンドする。
- generator.[[GeneratorState]]を
executing に設定する。 - genContextを
実行コンテキストスタック にプッシュする；genContextは現在の実行中の実行コンテキスト となる。 - genContextのサスペンドされた評価を再開する。その際、サスペンド操作の結果としてabruptCompletionを渡す。resultを再開された計算が返す
Completion Record とする。 Assert : ここでreturnした時点で、genContextは実行コンテキストスタック から既に除去されており、methodContextが現在の実行中の実行コンテキスト である。- ? resultを返す。
27.5.3.5 GetGeneratorKind ( )
抽象操作GetGeneratorKindは引数なしで呼び出され、
- genContextを
実行中の実行コンテキスト とする。 - もしgenContextがGenerator成分を持たないなら、
non-generator を返す。 - generatorをgenContextのGenerator成分とする。
- もしgeneratorが[[AsyncGeneratorState]]内部スロットを持つなら、
async を返す。 - それ以外の場合は
sync を返す。
27.5.3.6 GeneratorYield ( iteratorResult )
抽象操作GeneratorYieldは、引数iteratorResult（
- genContextを
実行中の実行コンテキスト とする。 Assert : genContextはジェネレーターの実行コンテキスト である。- generatorをgenContextのGenerator成分とする。
Assert :GetGeneratorKind ()はsync である。- generator.[[GeneratorState]]を
suspended-yield に設定する。 - genContextを
実行コンテキストスタック から削除し、実行コンテキスト スタックのトップにある実行コンテキストスタック を実行中の実行コンテキスト として復元する。 - callerContextを
実行中の実行コンテキスト とする。 - callerContextを再開し、
NormalCompletion (iteratorResult)を渡す。もしgenContextが再度再開された場合、resumptionValueを再開時に渡されたCompletion Record とする。 Assert : ここに到達した場合、genContextは再び実行中の実行コンテキスト である。- resumptionValueを返す。
27.5.3.7 Yield ( value )
抽象操作Yieldは引数value（
- generatorKindを
GetGeneratorKind ()とする。 - もしgeneratorKindが
async なら、?AsyncGeneratorYield (?Await (value))を返す。 - それ以外の場合、?
GeneratorYield (CreateIteratorResultObject (value,false ))を返す。
27.5.3.8 CreateIteratorFromClosure ( closure, generatorBrand, generatorPrototype [ , extraSlots ] )
抽象操作CreateIteratorFromClosureは引数closure（パラメータなしの
- 注: closureは
Yield 操作を用いてIteratorResultオブジェクト をyieldできる。 - もしextraSlotsが存在しない場合、extraSlotsを新しい空の
List に設定する。 - internalSlotsListを
リスト連結 でextraSlotsと« [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] »を結合したものとする。 - generatorを
OrdinaryObjectCreate (generatorPrototype, internalSlotsList)とする。 - generator.[[GeneratorBrand]]に generatorBrandを設定する。
- generator.[[GeneratorState]]に
suspended-start を設定する。 - callerContextを
実行中の実行コンテキスト とする。 - calleeContextを新しい
実行コンテキスト とする。 - calleeContextのFunctionを
null に設定する。 - calleeContextの
Realm を現在のRealmレコード に設定する。 - calleeContextのScriptOrModuleをcallerContextのScriptOrModuleに設定する。
- もしcallerContextがまだサスペンドされていなければ、callerContextをサスペンドする。
- calleeContextを
実行コンテキストスタック にプッシュする；calleeContextが実行中の実行コンテキスト となる。 GeneratorStart (generator, closure)を実行する。- calleeContextを
実行コンテキストスタック から取り除き、callerContextを実行中の実行コンテキスト として復元する。 - generatorを返す。
27.6 AsyncGeneratorオブジェクト
AsyncGeneratorはasync generator関数を呼び出すことで生成され、
AsyncGeneratorインスタンスは、生成元のasync
generator関数の
27.6.1 %AsyncGeneratorPrototype%オブジェクト
%AsyncGeneratorPrototype%オブジェクト:
- %AsyncGeneratorFunction.prototype.prototype%である。
通常のオブジェクト である。- AsyncGeneratorインスタンスではなく、[[AsyncGeneratorState]]内部スロットは持たない。
- [[Prototype]]内部スロットの値は
%AsyncIteratorPrototype% である。 - すべてのAsyncGeneratorインスタンスが間接的に継承するプロパティを持つ。
27.6.1.1 %AsyncGeneratorPrototype%.constructor
.constructorの初期値は
このプロパティの属性は { [[Writable]]:
27.6.1.2 %AsyncGeneratorPrototype%.next ( value )
- generatorを
this の値とする。 - promiseCapabilityを!
NewPromiseCapability (%Promise% )とする。 - resultを
Completion (AsyncGeneratorValidate (generator,empty ))とする。 IfAbruptRejectPromise (result, promiseCapability)を実行する。- stateをgenerator.[[AsyncGeneratorState]]とする。
- もしstateが
completed なら:- iteratorResultを
CreateIteratorResultObject (undefined ,true )とする。 - ! Call(promiseCapability.[[Resolve]],
undefined , « iteratorResult »)を実行する。 - promiseCapability.[[Promise]]を返す。
- iteratorResultを
- completionを
NormalCompletion (value)とする。 AsyncGeneratorEnqueue (generator, completion, promiseCapability)を実行する。- もしstateが
suspended-start またはsuspended-yield なら:AsyncGeneratorResume (generator, completion)を実行する。
- それ以外の場合:
Assert : stateはexecuting またはdraining-queue である。
- promiseCapability.[[Promise]]を返す。
27.6.1.3 %AsyncGeneratorPrototype%.return ( value )
- generatorを
this の値とする。 - promiseCapabilityを!
NewPromiseCapability (%Promise% )とする。 - resultを
Completion (AsyncGeneratorValidate (generator,empty ))とする。 IfAbruptRejectPromise (result, promiseCapability)を実行する。- completionを
ReturnCompletion (value)とする。 AsyncGeneratorEnqueue (generator, completion, promiseCapability)を実行する。- stateをgenerator.[[AsyncGeneratorState]]とする。
- もしstateが
suspended-start またはcompleted なら:- generator.[[AsyncGeneratorState]]に
draining-queue を設定する。 AsyncGeneratorAwaitReturn (generator)を実行する。
- generator.[[AsyncGeneratorState]]に
- それ以外でstateが
suspended-yield なら:AsyncGeneratorResume (generator, completion)を実行する。
- それ以外の場合:
Assert : stateはexecuting またはdraining-queue である。
- promiseCapability.[[Promise]]を返す。
27.6.1.4 %AsyncGeneratorPrototype%.throw ( exception )
- generatorを
this の値とする。 - promiseCapabilityを!
NewPromiseCapability (%Promise% )とする。 - resultを
Completion (AsyncGeneratorValidate (generator,empty ))とする。 IfAbruptRejectPromise (result, promiseCapability)を実行する。- stateをgenerator.[[AsyncGeneratorState]]とする。
- もしstateが
suspended-start なら:- generator.[[AsyncGeneratorState]]に
completed を設定する。 - stateに
completed を設定する。
- generator.[[AsyncGeneratorState]]に
- もしstateが
completed なら:- !
Call (promiseCapability.[[Reject]],undefined , « exception »)を実行する。 - promiseCapability.[[Promise]]を返す。
- !
- completionを
ThrowCompletion (exception)とする。 AsyncGeneratorEnqueue (generator, completion, promiseCapability)を実行する。- もしstateが
suspended-yield なら:AsyncGeneratorResume (generator, completion)を実行する。
- それ以外の場合:
Assert : stateはexecuting またはdraining-queue である。
- promiseCapability.[[Promise]]を返す。
27.6.1.5 %AsyncGeneratorPrototype% [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
27.6.2 AsyncGeneratorインスタンスのプロパティ
AsyncGeneratorインスタンスは以下に記載する内部スロットを持って初期化されます:
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[AsyncGeneratorState]] | async generatorの現在の実行状態。 | |
| [[AsyncGeneratorContext]] | このasync generatorのコードを実行する際に使用される |
|
| [[AsyncGeneratorQueue]] | ||
| [[GeneratorBrand]] | 文字列または |
async generatorの種類を区別するためのブランド。[[GeneratorBrand]]が |
27.6.3 AsyncGenerator抽象操作
27.6.3.1 AsyncGeneratorRequestレコード
AsyncGeneratorRequestは、async
generatorがどのように再開されるべきかの情報を格納し、対応するpromiseの履行または拒否のためのcapabilityを持つ
以下のフィールドを持ちます:
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Completion]] | async generatorを再開する際に使われる |
|
| [[Capability]] | この要求に関連付けられたpromise capability。 |
27.6.3.2 AsyncGeneratorStart ( generator, generatorBody )
抽象操作AsyncGeneratorStartは、引数generator（AsyncGenerator）、generatorBody（
Assert : generator.[[AsyncGeneratorState]]はsuspended-start である。- genContextを
実行中の実行コンテキスト とする。 - genContextのGeneratorコンポーネントにgeneratorを設定する。
- closureを新しい
抽象クロージャ （パラメータなし、generatorBodyをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- acGenContextを
実行中の実行コンテキスト とする。 - acGeneratorをacGenContextのGeneratorコンポーネントとする。
- もしgeneratorBodyが
Parse Node なら:- resultを
Completion (Evaluation of generatorBody)とする。
- resultを
- それ以外の場合:
Assert : generatorBodyはパラメータなしの抽象クロージャ である。- resultを
Completion (generatorBody())とする。
Assert : ここでreturnする場合、async generatorは例外を投げたか、暗黙または明示的なreturnを実行した。- acGenContextを
実行コンテキストスタック から除去し、スタックの一番上の実行コンテキスト を実行中の実行コンテキスト として復元する。 - acGenerator.[[AsyncGeneratorState]]に
draining-queue を設定する。 - もしresultが
正常完了 なら、resultをNormalCompletion (undefined )に設定する。 - もしresultが
return完了 なら、resultをNormalCompletion (result.[[Value]])に設定する。 AsyncGeneratorCompleteStep (acGenerator, result,true )を実行する。AsyncGeneratorDrainQueue (acGenerator)を実行する。NormalCompletion (undefined )を返す。
- acGenContextを
- genContextのコード評価状態を、評価が再開されたときclosureが引数なしで呼び出されるように設定する。
- generator.[[AsyncGeneratorContext]]にgenContextを設定する。
- generator.[[AsyncGeneratorQueue]]に新しい空の
List を設定する。 unused を返す。
27.6.3.3 AsyncGeneratorValidate ( generator, generatorBrand )
抽象操作AsyncGeneratorValidateは、引数generator（
- ?
RequireInternalSlot (generator, [[AsyncGeneratorContext]])を実行する。 - ?
RequireInternalSlot (generator, [[AsyncGeneratorState]])を実行する。 - ?
RequireInternalSlot (generator, [[AsyncGeneratorQueue]])を実行する。 - もしgenerator.[[GeneratorBrand]]が
generatorBrandと異なる場合、
TypeError 例外をthrowする。 unused を返す。
27.6.3.4 AsyncGeneratorEnqueue ( generator, completion, promiseCapability )
抽象操作AsyncGeneratorEnqueueは、引数generator（AsyncGenerator）、completion（
- requestを
AsyncGeneratorRequest { [[Completion]]: completion, [[Capability]]: promiseCapability }とする。 - requestをgenerator.[[AsyncGeneratorQueue]]に追加する。
unused を返す。
27.6.3.5 AsyncGeneratorCompleteStep ( generator, completion, done [ , realm ] )
抽象操作AsyncGeneratorCompleteStepは、引数generator（AsyncGenerator）、completion（
Assert : generator.[[AsyncGeneratorQueue]]は空でない。- nextをgenerator.[[AsyncGeneratorQueue]]の最初の要素とする。
- 最初の要素をgenerator.[[AsyncGeneratorQueue]]から除去する。
- promiseCapabilityをnext.[[Capability]]とする。
- valueをcompletion.[[Value]]とする。
- もしcompletionが
throw completion なら:- !
Call (promiseCapability.[[Reject]],undefined , « value »)を実行する。
- !
- それ以外の場合:
Assert : completionは正常完了 である。- もしrealmが存在する場合:
- oldRealmを
実行中の実行コンテキスト のRealm とする。 - 実行中の実行コンテキストの
Realm にrealmを設定する。 - iteratorResultを
CreateIteratorResultObject (value, done)とする。 - 実行中の実行コンテキストの
Realm にoldRealmを設定する。
- oldRealmを
- それ以外の場合:
- iteratorResultを
CreateIteratorResultObject (value, done)とする。
- iteratorResultを
- ! Call(promiseCapability.[[Resolve]],
undefined , « iteratorResult »)を実行する。
unused を返す。
27.6.3.6 AsyncGeneratorResume ( generator, completion )
抽象操作AsyncGeneratorResumeは、引数generator（AsyncGenerator）、completion（
Assert : generator.[[AsyncGeneratorState]]はsuspended-start またはsuspended-yield である。- genContextをgenerator.[[AsyncGeneratorContext]]とする。
- callerContextを
実行中の実行コンテキスト とする。 - callerContextをサスペンドする。
- generator.[[AsyncGeneratorState]]に
executing を設定する。 - genContextを
実行コンテキストスタック にプッシュする；genContextが実行中の実行コンテキスト となる。 - genContextのサスペンドされた評価をcompletionをサスペンド時の操作結果として再開する。再開された計算から返された
Completion Record をresultとする。 Assert : resultが異常完了 になることはない。Assert : ここでreturnする場合、genContextはすでに実行コンテキストスタック から除去され、callerContextが現在の実行中の実行コンテキスト である。unused を返す。
27.6.3.7 AsyncGeneratorUnwrapYieldResumption ( resumptionValue )
抽象操作AsyncGeneratorUnwrapYieldResumptionは、引数resumptionValue（
- もしresumptionValueが
return完了 でない場合、? resumptionValueを返す。 - awaitedを
Completion (Await (resumptionValue.[[Value]]))とする。 - もしawaitedが
throw完了 なら、? awaitedを返す。 Assert : awaitedは正常完了 である。ReturnCompletion (awaited.[[Value]])を返す。
27.6.3.8 AsyncGeneratorYield ( value )
抽象操作AsyncGeneratorYieldは引数value（
- genContextを
実行中の実行コンテキスト とする。 Assert : genContextはgeneratorの実行コンテキスト である。- generatorをgenContextのGeneratorコンポーネントとする。
Assert :GetGeneratorKind ()はasync である。- completionを
NormalCompletion (value)とする。 Assert :実行コンテキストスタック には少なくとも2つの要素がある。- previousContextを
実行コンテキストスタック の上から2番目の要素とする。 - previousRealmをpreviousContextの
Realm とする。 AsyncGeneratorCompleteStep (generator, completion,false , previousRealm)を実行する。- queueをgenerator.[[AsyncGeneratorQueue]]とする。
- もしqueueが空でないなら:
- 注: 実行はgeneratorをサスペンドせずに継続する。
- toYieldをqueueの最初の要素とする。
- resumptionValueを
Completion (toYield.[[Completion]])とする。 - ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue)を返す。
- それ以外の場合:
- generator.[[AsyncGeneratorState]]に
suspended-yield を設定する。 - genContextを
実行コンテキストスタック から除去し、スタックの一番上の実行コンテキスト を実行中の実行コンテキスト として復元する。 - callerContextを
実行中の実行コンテキスト とする。 - callerContextを
undefined を渡して再開する。もしgenContextが再度再開された場合、再開時に渡されたCompletion Record をresumptionValueとする。 Assert : ここで制御が到達した場合、genContextは再び実行中の実行コンテキスト である。- ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue)を返す。
- generator.[[AsyncGeneratorState]]に
27.6.3.9 AsyncGeneratorAwaitReturn ( generator )
抽象操作AsyncGeneratorAwaitReturnは引数generator（AsyncGenerator）を受け取り、
Assert : generator.[[AsyncGeneratorState]]はdraining-queue である。- queueをgenerator.[[AsyncGeneratorQueue]]とする。
Assert : queueは空でない。- nextをqueueの最初の要素とする。
- completionを
Completion (next.[[Completion]])とする。 Assert : completionはreturn完了 である。- promiseCompletionを
Completion (PromiseResolve (%Promise% , completion.[[Value]]))とする。 - もしpromiseCompletionが
異常完了 なら:AsyncGeneratorCompleteStep (generator, promiseCompletion,true )を実行する。AsyncGeneratorDrainQueue (generator)を実行する。unused を返す。
Assert : promiseCompletionは正常完了 である。- promiseをpromiseCompletion.[[Value]]とする。
- fulfilledClosureを新しい
抽象クロージャ （パラメータ(value), generatorをキャプチャ）とし、呼び出されたとき以下を実行するものとする:Assert : generator.[[AsyncGeneratorState]]はdraining-queue である。- resultを
NormalCompletion (value)とする。 AsyncGeneratorCompleteStep (generator, result,true )を実行する。AsyncGeneratorDrainQueue (generator)を実行する。NormalCompletion (undefined )を返す。
- onFulfilledを
CreateBuiltinFunction (fulfilledClosure, 1,"" , « »)とする。 - rejectedClosureを新しい
抽象クロージャ （パラメータ(reason), generatorをキャプチャ）とし、呼び出されたとき以下を実行するものとする:Assert : generator.[[AsyncGeneratorState]]はdraining-queue である。- resultを
ThrowCompletion (reason)とする。 AsyncGeneratorCompleteStep (generator, result,true )を実行する。AsyncGeneratorDrainQueue (generator)を実行する。NormalCompletion (undefined )を返す。
- onRejectedを
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)とする。 PerformPromiseThen (promise, onFulfilled, onRejected)を実行する。unused を返す。
27.6.3.10 AsyncGeneratorDrainQueue ( generator )
抽象操作AsyncGeneratorDrainQueueは引数generator（AsyncGenerator）を受け取り、
Assert : generator.[[AsyncGeneratorState]]はdraining-queue である。- queueをgenerator.[[AsyncGeneratorQueue]]とする。
- queueが空でない間、繰り返す:
- nextをqueueの最初の要素とする。
- completionを
Completion (next.[[Completion]])とする。 - もしcompletionが
return完了 なら:AsyncGeneratorAwaitReturn (generator)を実行する。unused を返す。
- それ以外の場合:
- もしcompletionが
正常完了 なら:- completionを
NormalCompletion (undefined )に設定する。
- completionを
AsyncGeneratorCompleteStep (generator, completion,true )を実行する。
- もしcompletionが
- generator.[[AsyncGeneratorState]]に
completed を設定する。 unused を返す。
27.6.3.11 CreateAsyncIteratorFromClosure ( closure, generatorBrand, generatorPrototype )
抽象操作CreateAsyncIteratorFromClosureは引数closure（パラメータなしの
- 注: closureは
Await 操作や、Yield 操作によるIteratorResultオブジェクト のyieldを含む場合がある。 - internalSlotsListを« [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] »とする。
- generatorを
OrdinaryObjectCreate (generatorPrototype, internalSlotsList)とする。 - generator.[[GeneratorBrand]]にgeneratorBrandを設定する。
- generator.[[AsyncGeneratorState]]に
suspended-start を設定する。 - callerContextを
実行中の実行コンテキスト とする。 - calleeContextを新しい
実行コンテキスト とする。 - calleeContextのFunctionに
null を設定する。 - calleeContextの
Realm に現在のRealmレコード を設定する。 - calleeContextのScriptOrModuleにcallerContextのScriptOrModuleを設定する。
- もしcallerContextがまだサスペンドされていなければ、callerContextをサスペンドする。
- calleeContextを
実行コンテキストスタック にプッシュする；calleeContextが実行中の実行コンテキスト となる。 AsyncGeneratorStart (generator, closure)を実行する。- calleeContextを
実行コンテキストスタック から除去し、callerContextを実行中の実行コンテキスト として復元する。 - generatorを返す。
27.7 AsyncFunctionオブジェクト
AsyncFunctionは、通常
27.7.1 AsyncFunctionコンストラクター
AsyncFunction
- %AsyncFunction%である。
Functionのサブクラスである。- コンストラクターとしてではなく関数として呼び出された場合、新しいAsyncFunctionを生成し初期化する。したがって、関数呼び出し
AsyncFunction(…)は、同じ引数によるnew AsyncFunction(…)のオブジェクト生成式と等価である。 - クラス定義の
extends句の値として使用することができる。指定されたAsyncFunctionの動作を継承するサブクラスコンストラクター は、組み込みのAsyncFunctionの動作に必要な内部スロットでサブクラスインスタンスを生成・初期化するため、AsyncFunctionコンストラクター へのsuper呼び出しを含める必要がある。async関数オブジェクト を定義するすべてのECMAScript構文形式は、AsyncFunctionの直接インスタンスを生成する。AsyncFunctionサブクラスのインスタンスを生成する構文手段は存在しない。
27.7.1.1 AsyncFunction ( ...parameterArgs, bodyArg )
最後の引数（ある場合）はasync関数の本体（実行コード）を指定し、それ以前の引数は仮引数を指定します。
この関数は呼び出されたとき、以下のステップを実行します:
- Cを
アクティブ関数オブジェクト とする。 - もしbodyArgが存在しない場合、bodyArgを空文字列に設定する。
- ?
CreateDynamicFunction (C, NewTarget,async , parameterArgs, bodyArg)を返す。
27.7.2 AsyncFunctionコンストラクターのプロパティ
AsyncFunction
- 標準の組み込み
関数オブジェクト で、Functionコンストラクター から継承する。 - [[Prototype]]内部スロットの値は
%Function% である。 "length" プロパティの値は1 𝔽である。"name" プロパティの値は"AsyncFunction" である。- 以下のプロパティを持つ：
27.7.2.1 AsyncFunction.prototype
AsyncFunction.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
27.7.3 AsyncFunctionプロトタイプオブジェクトのプロパティ
AsyncFunctionプロトタイプオブジェクト:
- %AsyncFunction.prototype%である。
通常のオブジェクト である。関数オブジェクト ではなく、[[ECMAScriptCode]]内部スロットや、表30 に記載されている他の内部スロットを持たない。- [[Prototype]]内部スロットの値は
%Function.prototype% である。
27.7.3.1 AsyncFunction.prototype.constructor
AsyncFunction.prototype.constructorの初期値は
このプロパティの属性は { [[Writable]]:
27.7.3.2 AsyncFunction.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
27.7.4 AsyncFunctionインスタンス
すべてのAsyncFunctionインスタンスはECMAScriptの
各AsyncFunctionインスタンスは以下の独自プロパティを持ちます:
27.7.4.1 length
27.7.4.2 name
27.7.5 AsyncFunction抽象操作
27.7.5.1 AsyncFunctionStart ( promiseCapability, asyncFunctionBody )
抽象操作AsyncFunctionStartは、引数promiseCapability（
- runningContextを
実行中の実行コンテキスト とする。 - asyncContextをrunningContextのコピーとする。
- 注: 実行状態のコピーは
AsyncBlockStart による再開に必要。現在実行中のコンテキストを再開するのは未定義。 AsyncBlockStart (promiseCapability, asyncFunctionBody, asyncContext)を実行する。unused を返す。
27.7.5.2 AsyncBlockStart ( promiseCapability, asyncBody, asyncContext )
抽象操作AsyncBlockStartは、引数promiseCapability（
- runningContextを
実行中の実行コンテキスト とする。 - closureを新しい
抽象クロージャ （パラメータなし、promiseCapabilityとasyncBodyをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- acAsyncContextを
実行中の実行コンテキスト とする。 - もしasyncBodyが
Parse Node なら:- resultを
Completion (Evaluation of asyncBody)とする。
- resultを
- それ以外の場合:
Assert : asyncBodyはパラメータなしの抽象クロージャ である。- resultを
Completion (asyncBody())とする。
Assert : ここでreturnした場合、async関数は例外を投げるか、暗黙または明示的なreturnを実行し、すべてのawaitが完了している。- acAsyncContextを
実行コンテキストスタック から除去し、スタックの一番上の実行コンテキスト を実行中の実行コンテキスト として復元する。 - もしresultが
正常完了 なら:- !
Call (promiseCapability.[[Resolve]],undefined , «undefined »)を実行する。
- !
- それ以外でresultが
return完了 なら:- ! Call(promiseCapability.[[Resolve]],
undefined , « result.[[Value]] »)を実行する。
- ! Call(promiseCapability.[[Resolve]],
- それ以外の場合:
NormalCompletion (unused )を返す。
- acAsyncContextを
- asyncContextのコード評価状態を、評価が再開されたときclosureが引数なしで呼び出されるように設定する。
- asyncContextを
実行コンテキストスタック にプッシュする；asyncContextが実行中の実行コンテキスト となる。 - asyncContextのサスペンドされた評価を再開する。再開された計算から返された値をresultとする。
Assert : ここでreturnした場合、asyncContextはすでに実行コンテキストスタック から除去され、runningContextが現在の実行中の実行コンテキスト である。Assert : resultは正常完了 （値はunused ）。この値の起源はAwait またはawaitしない場合は上記2.i 。unused を返す。
27.7.5.3 Await ( value )
抽象操作Awaitは引数value（
- asyncContextを
実行中の実行コンテキスト とする。 - promiseを?
PromiseResolve (%Promise% , value)とする。 - fulfilledClosureを新しい
抽象クロージャ （パラメータ(v), asyncContextをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- prevContextを
実行中の実行コンテキスト とする。 - prevContextをサスペンドする。
- asyncContextを
実行コンテキストスタック にプッシュする；asyncContextが実行中の実行コンテキスト となる。 - asyncContextのサスペンドされた評価を再開する。サスペンド時の操作結果として
NormalCompletion (v)を渡す。 Assert : このステップに到達した時点で、asyncContextはすでに実行コンテキストスタック から除去され、prevContextが現在の実行中の実行コンテキスト である。NormalCompletion (undefined )を返す。
- prevContextを
- onFulfilledを
CreateBuiltinFunction (fulfilledClosure, 1,"" , « »)とする。 - rejectedClosureを新しい
抽象クロージャ （パラメータ(reason), asyncContextをキャプチャ）とし、呼び出されたとき以下を実行するものとする:- prevContextを
実行中の実行コンテキスト とする。 - prevContextをサスペンドする。
- asyncContextを
実行コンテキストスタック にプッシュする；asyncContextが実行中の実行コンテキスト となる。 - asyncContextのサスペンドされた評価を再開する。サスペンド時の操作結果として
ThrowCompletion (reason)を渡す。 Assert : このステップに到達した時点で、asyncContextはすでに実行コンテキストスタック から除去され、prevContextが現在の実行中の実行コンテキスト である。NormalCompletion (undefined )を返す。
- prevContextを
- onRejectedを
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)とする。 PerformPromiseThen (promise, onFulfilled, onRejected)を実行する。- asyncContextを
実行コンテキストスタック から除去し、スタックの一番上の実行コンテキスト を実行中の実行コンテキスト として復元する。 - callerContextを
実行中の実行コンテキスト とする。 - callerContextを
empty を渡して再開する。もしasyncContextが再度再開された場合、再開時に渡されたCompletion Record をcompletionとする。 Assert : ここで制御が到達した場合、asyncContextは再び実行中の実行コンテキスト である。- completionを返す。
28 リフレクション
28.1 Reflect オブジェクト
Reflect オブジェクトは：
- %Reflect%です。
"Reflect" プロパティの初期値であり、グローバル オブジェクト のプロパティです。通常のオブジェクト です。- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。 関数オブジェクト ではありません。- [[Construct]] 内部メソッドを持ちません。
new演算子によるコンストラクタ として使用できません。 - [[Call]] 内部メソッドを持ちません。関数として呼び出すことはできません。
28.1.1 Reflect.apply ( target, thisArgument, argumentsList )
この関数が呼び出されたとき、次の手順を実行します：
IsCallable (target) がfalse の場合、TypeError 例外を投げる。- args に ?
CreateListFromArrayLike (argumentsList) を設定する。 PrepareForTailCall () を実行する。- ?
Call (target, thisArgument, args) を返す。
28.1.2 Reflect.construct ( target, argumentsList [ , newTarget ] )
この関数が呼び出されたとき、次の手順を実行します：
IsConstructor (target) がfalse の場合、TypeError 例外を投げる。- newTarget が存在しない場合、newTarget に target を設定する。
- それ以外で
IsConstructor (newTarget) がfalse の場合、TypeError 例外を投げる。 - args に ?
CreateListFromArrayLike (argumentsList) を設定する。 - ?
Construct (target, args, newTarget) を返す。
28.1.3 Reflect.defineProperty ( target, propertyKey, attributes )
この関数が呼び出されたとき、次の手順を実行します：
- target が
オブジェクトでない場合 、TypeError 例外を投げる。 - key に ?
ToPropertyKey (propertyKey) を設定する。 - desc に ?
ToPropertyDescriptor (attributes) を設定する。 - ? target.[[DefineOwnProperty]](key, desc) を返す。
28.1.4 Reflect.deleteProperty ( target, propertyKey )
この関数が呼び出されたとき、次の手順を実行します：
- target が
オブジェクトでない場合 、TypeError 例外を投げる。 - key に ?
ToPropertyKey (propertyKey) を設定する。 - ? target.[[Delete]](key) を返す。
28.1.5 Reflect.get ( target, propertyKey [ , receiver ] )
この関数が呼び出されたとき、次の手順を実行します：
- target が
オブジェクトでない場合 、TypeError 例外を投げる。 - key に ?
ToPropertyKey (propertyKey) を設定する。 - receiver が存在しない場合
- receiver に target を設定する。
- ? target.[[Get]](key, receiver) を返す。
28.1.6 Reflect.getOwnPropertyDescriptor ( target, propertyKey )
この関数が呼び出されたとき、次の手順を実行します：
- target が
オブジェクトでない場合 、TypeError 例外を投げる。 - key に ?
ToPropertyKey (propertyKey) を設定する。 - desc に ? target.[[GetOwnProperty]](key) を設定する。
FromPropertyDescriptor (desc) を返す。
28.1.7 Reflect.getPrototypeOf ( target )
この関数が呼び出されたとき、次の手順を実行します：
- target が
オブジェクトでない場合 、TypeError 例外を投げる。 - ? target.[[GetPrototypeOf]]() を返す。
28.1.8 Reflect.has ( target, propertyKey )
この関数が呼び出されたとき、次の手順を実行します：
- target が
オブジェクトでない場合 、TypeError 例外を投げる。 - key に ?
ToPropertyKey (propertyKey) を設定する。 - ? target.[[HasProperty]](key) を返す。
28.1.9 Reflect.isExtensible ( target )
この関数が呼び出されたとき、次の手順を実行します：
- target が
オブジェクトでない場合 、TypeError 例外を投げる。 - ? target.[[IsExtensible]]() を返す。
28.1.10 Reflect.ownKeys ( target )
この関数が呼び出されたとき、次の手順を実行します：
- target が
オブジェクトでない場合 、TypeError 例外を投げる。 - keys に ? target.[[OwnPropertyKeys]]() を設定する。
CreateArrayFromList (keys) を返す。
28.1.11 Reflect.preventExtensions ( target )
この関数が呼び出されたとき、次の手順を実行します：
- target が
オブジェクトでない場合 、TypeError 例外を投げる。 - ? target.[[PreventExtensions]]() を返す。
28.1.12 Reflect.set ( target, propertyKey, V [ , receiver ] )
この関数が呼び出されたとき、次の手順を実行します：
- target が
オブジェクトでない場合 、TypeError 例外を投げる。 - key に ?
ToPropertyKey (propertyKey) を設定する。 - receiver が存在しない場合
- receiver に target を設定する。
- ? target.[[Set]](key, V, receiver) を返す。
28.1.13 Reflect.setPrototypeOf ( target, proto )
この関数が呼び出されたとき、次の手順を実行します：
- target が
オブジェクトでない場合 、TypeError 例外を投げる。 - proto が
オブジェクトでない場合 かつ proto がnull でない場合、TypeError 例外を投げる。 - ? target.[[SetPrototypeOf]](proto) を返す。
28.1.14 Reflect [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
28.2 プロキシオブジェクト
28.2.1 Proxy コンストラクタ
Proxy
- %Proxy%です。
"Proxy" プロパティの初期値であり、グローバルオブジェクト のプロパティです。コンストラクタ として呼び出されたとき、新しい Proxy オブジェクトを作成し初期化します。- 関数として呼び出すことは意図されておらず、その場合は例外をスローします。
28.2.1.1 Proxy ( target, handler )
この関数が呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外を投げる。 - ?
ProxyCreate (target, handler) を返す。
28.2.2 Proxy コンストラクタのプロパティ
Proxy
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 "prototype" プロパティを持ちません。Proxy オブジェクトは初期化が必要な [[Prototype]] 内部スロットを持たないためです。- 以下のプロパティを持ちます：
28.2.2.1 Proxy.revocable ( target, handler )
この関数は取り消し可能な Proxy オブジェクトを作成します。
呼び出されたとき、次の手順を実行します：
- proxy に ?
ProxyCreate (target, handler) を設定する。 - パラメータなしで何もキャプチャしない新しい
抽象クロージャ を revokerClosure とし、呼び出し時に次の手順を実行する：- F を
アクティブな関数オブジェクト とする。 - p を F.[[RevocableProxy]] とする。
- p が
null の場合、NormalCompletion (undefined ) を返す。 - F.[[RevocableProxy]] を
null に設定する。 アサート ：p はProxy エキゾチックオブジェクト である。- p.[[ProxyTarget]] を
null に設定する。 - p.[[ProxyHandler]] を
null に設定する。 NormalCompletion (undefined ) を返す。
- F を
- revoker を
CreateBuiltinFunction (revokerClosure, 0,"" , « [[RevocableProxy]] ») とする。 - revoker.[[RevocableProxy]] を proxy に設定する。
- result を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - !
CreateDataPropertyOrThrow (result,"proxy" , proxy) を実行する。 - !
CreateDataPropertyOrThrow (result,"revoke" , revoker) を実行する。 - result を返す。
28.3 モジュール名前空間オブジェクト
モジュール名前空間オブジェクトは、
28.3.1 %Symbol.toStringTag%
このプロパティの属性は { [[Writable]]:
29 メモリモデル
メモリ一貫性モデル、またはメモリモデルは、
メモリモデルは、SharedArrayBuffer 上の
29.1 メモリモデルの基礎
共有メモリアクセス（読み書き）は、以下で定義される2つのグループ、アトミックアクセスとデータアクセスに分けられます。アトミックアクセスは逐次一貫性があり、すべての
逐次一貫性より弱く、unordered より強い順序（例：release-acquire）はサポートされません。
共有データブロックイベントは、ReadSharedMemory、WriteSharedMemory、またはReadModifyWriteSharedMemoryの
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Order]] | このイベントに対して |
|
| [[NoTear]] | 真偽値 | このイベントが同じ範囲を持つ複数の書き込みイベントから読み取ることが許されるかどうか。 |
| [[Block]] | イベントが操作するブロック。 | |
| [[ByteIndex]] | 非負の |
[[Block]]内の読み取りのバイトアドレス。 |
| [[ElementSize]] | 非負の |
読み取りのサイズ。 |
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Order]] | このイベントに対して |
|
| [[NoTear]] | 真偽値 | このイベントが同じ範囲を持つ複数の読み取りイベントから読み取られることが許されるかどうか。 |
| [[Block]] | イベントが操作するブロック。 | |
| [[ByteIndex]] | 非負の |
[[Block]]内の書き込みのバイトアドレス。 |
| [[ElementSize]] | 非負の |
書き込みのサイズ。 |
| [[Payload]] | 他のイベントによって読み取られる |
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Order]] | Read-modify-write イベントは常に逐次一貫性を持ちます。 | |
| [[NoTear]] | Read-modify-write イベントはティア（断片化）しません。 | |
| [[Block]] | イベントが操作するブロック。 | |
| [[ByteIndex]] | 非負の |
[[Block]]内のread-modify-writeのバイトアドレス。 |
| [[ElementSize]] | 非負の |
read-modify-write のサイズ。 |
| [[Payload]] | [[ModifyOp]]に渡す |
|
| [[ModifyOp]] | 抽象クロージャであり、読み取った |
これらのイベントは、
一部の操作はSynchronizeイベントも導入する場合があります。Synchronize イベントはフィールドを持たず、他のイベントの許容される順序を直接制約するためだけに存在します。
ReadSharedMemory、WriteSharedMemory、ReadModifyWriteSharedMemory イベントの範囲は、[[ByteIndex]] から [[ByteIndex]] + [[ElementSize]] - 1 までの連続した
postMessage）、
イベントは、以下で定義される関係によって
29.2 エージェントイベントレコード
エージェントイベントレコードは、以下のフィールドを持つ
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[AgentSignifier]] | この順序付けの評価をもたらした |
|
| [[EventList]] | 評価中にイベントがリストに追加される。 | |
| [[AgentSynchronizesWith]] | 操作的意味論で導入される |
29.3 選択値レコード
選択値レコードは、以下のフィールドを持つ
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Event]] | この選択値に対して導入された |
|
| [[ChosenValue]] | 評価中に非決定的に選択されたバイト。 |
29.4 候補実行
候補実行は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[EventsRecords]] | ||
| [[ChosenValues]] |
29.5 メモリモデルのための抽象操作
29.5.1 EventSet ( execution )
抽象操作 EventSet は、引数execution（
- eventsを空集合とする。
- execution.[[EventsRecords]]の各
エージェントイベントレコード aerについて、- aer.[[EventList]]の各イベントEについて
- Eをeventsに追加する。
- aer.[[EventList]]の各イベントEについて
- eventsを返す。
29.5.2 SharedDataBlockEventSet ( execution )
抽象操作 SharedDataBlockEventSet は、引数execution（
- eventsを空集合とする。
EventSet (execution)の各イベントEについて、- Eが
ReadSharedMemory 、WriteSharedMemory 、 またはReadModifyWriteSharedMemory イベントの場合、Eをeventsに追加する。
- Eが
- eventsを返す。
29.5.3 HostEventSet ( execution )
抽象操作 HostEventSet は、引数execution（
- eventsを空集合とする。
EventSet (execution)の各イベントEについて、- Eが
SharedDataBlockEventSet (execution)に含まれていない場合、Eをeventsに追加する。
- Eが
- eventsを返す。
29.5.4 ComposeWriteEventBytes ( execution, byteIndex, Ws )
抽象操作 ComposeWriteEventBytes は、引数execution（
- byteLocationをbyteIndexとする。
- bytesReadを新しい空の
List とする。 - Wsの各要素Wについて、
アサート ：Wの範囲にbyteLocationが含まれている。- payloadIndexをbyteLocation - W.[[ByteIndex]]とする。
- Wが
WriteSharedMemory イベントの場合- byteをW.[[Payload]][payloadIndex]とする。
- それ以外の場合、
アサート ：WはReadModifyWriteSharedMemory イベントである。- bytesを
ValueOfReadEvent (execution, W)とする。 - bytesModifiedをW.[[ModifyOp]](bytes, W.[[Payload]])とする。
- byteを bytesModified[payloadIndex]とする。
- byteをbytesReadに追加する。
- byteLocationをbyteLocation + 1に設定する。
- bytesReadを返す。
read-modify-write修正[[ModifyOp]]は、
この抽象操作は、書き込みイベントの
29.5.5 ValueOfReadEvent ( execution, R )
抽象操作 ValueOfReadEvent は、引数execution（
- Wsを
reads-bytes-from (R) in executionとする。 アサート ： WsはList であり、WriteSharedMemory またはReadModifyWriteSharedMemory イベントで、長さはR.[[ElementSize]]と等しい。ComposeWriteEventBytes (execution, R.[[ByteIndex]], Ws)を返す。
29.6 候補実行の関係
以下の関係および数学関数は、特定の
29.6.1 is-agent-order-before
- イベントEとDについて、Eはexecution内でis-agent-order-before
Dであるとは、execution.[[EventsRecords]]内に
エージェントイベントレコード aerが存在し、aer.[[EventList]]がEとDの両方を含み、かつEがList 順序でDより前にある場合です。
29.6.2 reads-bytes-from
-
ReadSharedMemory またはReadModifyWriteSharedMemory イベントRについて、SharedDataBlockEventSet (execution)に含まれるなら、reads-bytes-from(R) in executionは、長さR.[[ElementSize]]のWriteSharedMemory またはReadModifyWriteSharedMemory イベントWsのList で、以下がすべて成り立つものです。- インデックスiの各イベントWは、R.[[ByteIndex]] + iをその範囲に含むこと。
- R自身がWsに含まれていないこと。
29.6.3 reads-from
- イベントRとWについて、
SharedDataBlockEventSet (execution) がRとWの両方を含み、かつreads-bytes-from (R) in executionがWを含むとき、Rはexecution内でreads-from Wである。
29.6.4 host-synchronizes-with
- EがDとexecution内でhost-synchronizes-withであるなら、
HostEventSet (execution)がEとDの両方を含むこと。 - host-synchronizes-withと
is-agent-order-before の合併に循環がないこと。
29.6.5 synchronizes-with
-
イベントRとWについて、WはRとexecution内でsynchronizes-withであるとは、Rが
reads-from Wであり、R.[[Order]]がseq-cst 、W.[[Order]]もseq-cst 、かつRとWの範囲が等しい場合です。 -
execution.[[EventsRecords]]の各要素eventsRecordについて、以下が成り立つ。
- イベントSとSwについて、eventsRecord.[[AgentSynchronizesWith]]に(S, Sw)が含まれるとき、SはSwとexecution内でsynchronizes-withである。
- イベントEとDについて、execution.[[HostSynchronizesWith]]に(E, D)が含まれるとき、EはDとexecution内でsynchronizes-withである。
29.6.6 happens-before
-
イベントEとDについて、Eはexecution内でhappens-before Dであるとは、以下のいずれかが成り立つ場合です。
- Eが
is-agent-order-before Dである。 - Eが
synchronizes-with Dである。 SharedDataBlockEventSet (execution) がEとDの両方を含み、E.[[Order]]がinit 、かつEとDの範囲が重複している。- イベントFが存在し、EがFよりhappens-before、かつFがDよりhappens-beforeである。
- Eが
29.7 有効な実行の性質
29.7.1 有効な選択読み取り
ReadSharedMemory またはReadModifyWriteSharedMemory イベント R についてSharedDataBlockEventSet (execution) 内で、- chosenValueRecord を execution.[[ChosenValues]] の [[Event]] フィールドが R である要素とする。
- chosenValue を chosenValueRecord.[[ChosenValue]] とする。
- readValue を
ValueOfReadEvent (execution, R) とする。 - chosenLen を chosenValue の要素数とする。
- readLen を readValue の要素数とする。
- chosenLen ≠ readLen ならば、
false を返す。
- 何らかの
整数 i が 0（含む）から chosenLen（含まない）までの区間 で、chosenValue[i] ≠ readValue[i] ならば、false を返す。
true を返す。
29.7.2 コヒーレント読み取り
ReadSharedMemory またはReadModifyWriteSharedMemory イベント R についてSharedDataBlockEventSet (execution) 内で、- Ws を
reads-bytes-from (R) in execution とする。 - byteLocation を R.[[ByteIndex]] とする。
- Ws の各要素 W について、
- R が
happens-before W in execution ならば、false を返す。
- もし
WriteSharedMemory またはReadModifyWriteSharedMemory イベント V で byteLocation がその範囲にあり、かつ W がhappens-before V in execution かつ V がhappens-before R in execution ならば、false を返す。
- byteLocation を byteLocation + 1 に設定する。
- R が
- Ws を
true を返す。
29.7.3 ティアフリー読み取り
ReadSharedMemory またはReadModifyWriteSharedMemory イベント R についてSharedDataBlockEventSet (execution) 内で、- R.[[NoTear]] が
true ならば、Assert : R.[[ByteIndex]] を R.[[ElementSize]] で割った余りが 0 であること。- execution 内で R が
reads-from W であり、かつ W.[[NoTear]] がtrue である各イベント W について、- R と W が等しい範囲を持ち、かつ V
というイベントが存在し、V と W
が等しい範囲を持ち、V.[[NoTear]] が
true 、W と V が同じ共有データブロックイベント でなく、かつ R がreads-from V である場合、false を返す。
- R と W が等しい範囲を持ち、かつ V
というイベントが存在し、V と W
が等しい範囲を持ち、V.[[NoTear]] が
- R.[[NoTear]] が
true を返す。
イベントの [[NoTear]] フィールドが
直感的には、この要件は整数
29.7.4 逐次一貫的アトミクス
- イベント E と D について、E が execution 内で
is-memory-order-before D であるとは、E が
happens-before D である場合です。 -
イベント R と W について、R が
reads-from W であるとき、WriteSharedMemory またはReadModifyWriteSharedMemory イベント V がSharedDataBlockEventSet (execution) に存在し、V.[[Order]] がseq-cst 、W が is-memory-order-before V、V が is-memory-order-before R、かつ以下のいずれかが成り立つ場合は許されません。- W が
synchronizes-with R であり、かつ V と R が等しい範囲を持つ。 - W が
happens-before R かつ V がhappens-before R であり、W.[[Order]] がseq-cst 、W と V が等しい範囲を持つ。 - W が
happens-before R かつ W がhappens-before V であり、R.[[Order]] がseq-cst 、V と R が等しい範囲を持つ。
注1 この条項は、さらに
seq-cst イベント同士で範囲が等しい場合に制約を加えます。 - W が
-
WriteSharedMemory またはReadModifyWriteSharedMemory イベント W についてSharedDataBlockEventSet (execution) 内で、W.[[Order]] がseq-cst ならば、is-memory-order-before W となる範囲が等しいReadSharedMemory またはReadModifyWriteSharedMemory イベントが無限個存在することはありません。注2
is-memory-order-before は
29.7.5 有効な実行
ホスト がhost-synchronizes-with Relation を execution 用に提供する。- execution が
happens-before Relation を許し、それが厳密な部分順序 である。 - execution は有効な選択読み取りを持つ。
- execution はコヒーレントな読み取りを持つ。
- execution はティアフリー読み取りを持つ。
- execution は逐次一貫的アトミクスを持つ。
すべてのプログラムは少なくとも1つの有効な実行を持ちます。
29.8 レース
実行 execution と E, D というイベントが
- E と D が同じ
共有データブロックイベント でない場合、- E
happens-before D in execution と Dhappens-before E in execution の両方が成り立つわけではない場合、- E と D の両方が
WriteSharedMemory またはReadModifyWriteSharedMemory イベントであり、かつ E と D の範囲が互いに独立していない場合、true を返す。
- E が
reads-from D in execution または D がreads-from E in execution の場合、true を返す。
- E と D の両方が
- E
false を返す。
29.9 データレース
実行 execution と E, D というイベントが
- E と D が
レース 状態にある場合、- E.[[Order]] が
seq-cst でない、または D.[[Order]] がseq-cst でない場合、true を返す。
- E と D の範囲が重複している場合、
true を返す。
- E.[[Order]] が
false を返す。
29.10 データレースフリー
実行 execution は、
プログラムは、そのすべての実行がデータレースフリーである場合、データレースフリーである。
29.11 共有メモリのガイドライン
以下は共有メモリを扱う ECMAScript プログラマー向けのガイドラインです。
プログラムは
より一般的には、プログラムが
以下は共有メモリを扱うプログラムのためにコンパイラ変換を書く ECMAScript 実装者向けのガイドラインです。
単一
エージェント順スライスとは、単一
読み取りイベントの可能な読み取り値とは、そのイベントについてすべての有効な実行で
共有メモリがない場合に有効なエージェント順スライスの変換は、以下の例外を除き、共有メモリが存在しても有効です。
-
アトミクスは絶対順守: プログラム変換は、エージェント順スライス内の
seq-cst イベントとそのunordered 操作との並べ替え、seq-cst 操作同士の並べ替え、またはis-agent-order-before Relation からseq-cst 操作を除去することはできません。（実際には並べ替え禁止により、コンパイラはすべての
seq-cst 操作が同期であり、最終的なis-memory-order-before Relation に含まれると見なす必要がある（通常、エージェント間解析がない場合はそう見なす）。また、呼び出し先のメモリ順序への影響が不明な呼び出しもseq-cst 操作を含むと見なす必要がある。） -
読み取りは安定でなければならない: ある共有メモリの読み取りは、実行中に1つの値だけを観測しなければならない。
（例えば、プログラム上で意味的に1回の読み取りが複数回実行される場合、その後に観測できる値は1つだけとなる。リマテリアライゼーション（rematerialization）と呼ばれる変換はこの規則に違反する可能性がある。）
-
書き込みは安定でなければならない: 観測可能なすべての共有メモリへの書き込みは、実行上のプログラム意味論に従っていなければならない。
（例えば、変換によって観測可能な書き込みを導入してはならない。大きな領域への read-modify-write 操作で小さなデータを書き込む、プログラムが書き得ない値を書き込む、他エージェントによって上書きされ得る場所に直前の読み値を書き戻すなどは不可。）
-
可能な読み取り値は空であってはならない: プログラム変換によって共有メモリ読み取りの可能な値が空になることは許されない。
（直観に反して、この規則は実質的に書き込みへの変換に制約を課す。書き込みは
メモリモデル 内で読み取りイベントによって読まれる限り、力を持つ。例えば、書き込みはseq-cst 操作間で移動や合成、並べ替えが可能だが、すべての更新書き込みを除去することはできない。少なくとも1つは残す必要がある。）
有効な変換例：同じ場所への複数の非アトミック読み取りの合成、非アトミック読み取りの並べ替え、投機的非アトミック読み取りの導入、同じ場所への複数の非アトミック書き込みの合成、異なる場所への非アトミック書き込みの並べ替え、ループ外への非アトミック読み取りの昇格（終了条件に影響があっても）。一般に、エイリアスされた
以下は共有メモリアクセスの機械語生成を行う ECMAScript 実装者向けのガイドラインです。
ARM や Power
より弱くないメモリモデルを持つアーキテクチャでは、非アトミックストア・ロードはターゲットアーキテクチャの単純なストアやロードにコンパイルできます。アトミックストア・ロードは逐次一貫性を保証する命令にコンパイルできます。そうした命令がなければ、メモリバリアを使用し、ストアやロードの両側にバリアを配置します。read-modify-write
操作は、x86 の LOCK プレフィックス命令、ARM の load-exclusive/store-exclusive、Power の
load-link/store-conditional など、ターゲットアーキテクチャの read-modify-write 命令にコンパイルできます。
特に、
- プログラム内のすべてのアトミック操作は必要であると仮定されます。
- アトミック操作は、他のアトミック操作や非アトミック操作との並び替えはされません。
- 関数呼び出しは常にアトミック操作を行うものと仮定されます。
- アトミック操作は、より大きなデータへの read-modify-write 操作としては実装されず、プラットフォームに適切なサイズのアトミック操作がなければロックフリーではないアトミックとして実装されます（各プラットフォームにはすべての興味深いサイズの通常メモリアクセス命令があるものと仮定）。
素朴なコード生成は以下のパターンを用います：
- 通常のロード・ストアは単一のロード・ストア命令にコンパイルされる。
- ロックフリーのアトミックロード・ストアは、完全フェンス、通常のロード・ストア、完全フェンスにコンパイルされる。
- ロックフリーのアトミック read-modify-write は、完全フェンス、アトミック read-modify-write 命令列、完全フェンスにコンパイルされる。
- ロックフリーでないアトミックは、スピンロックの取得、完全フェンス、一連の非アトミックロード・ストア命令、完全フェンス、スピンロックの解放にコンパイルされる。
このマッピングは、アドレス範囲へのアトミック操作が非アトミック書き込みや異なるサイズのアトミック操作とレースしない限り正しい。しかしそれで十分です：
これら基本パターンの局所的な改良も、
- 明らかにプラットフォーム依存の最適化で、冗長なフェンスを除去できる。例えば x86
ではロックフリーのアトミックロード・ストア周辺のフェンスは通常不要で、ストア後のフェンスのみ必要。ロックフリーの read-modify-write にはフェンス不要（すべて
LOCKプレフィックス命令）。多くのプラットフォームでは強さの異なるフェンスがあり、文脈によって弱いフェンスを使っても逐次一貫性が壊れない。 - 現代の多くのプラットフォームは ECMAScript アトミクスが要求するすべてのデータサイズでロックフリーアトミクスをサポート。ロックフリーでないアトミクスが必要な場合、アトミック操作本体のフェンスは通常ロック・アンロック処理に吸収できる。最も簡単なロックフリーでないアトミクスは SharedArrayBuffer ごとに単一のロックワードを持つこと。
- さらに複雑なプラットフォーム依存の局所最適化もあり、コード解析が必要な場合がある。例えば連続した2つのフェンスは1つのフェンスと効果が同じなので、2つのアトミック操作が連続して生成された場合、間に1つのフェンスだけでよい。x86 では、アトミックストア間のフェンスも省略できる（ストア後のフェンスは次のロードを分離するためだけに必要）。
付録A (参考) 文法まとめ
A.1 字句文法
A.2 式
When processing an instance of the production
the interpretation of
When processing an instance of the production
the interpretation of
In certain circumstances when processing an instance of the production
the interpretation of
A.3 文
A.4 関数とクラス
When processing an instance of the production
the interpretation of
When processing an instance of the production
the interpretation of
A.5 スクリプトとモジュール
A.6 数値変換
All grammar symbols not explicitly defined by the
A.7 タイムゾーンオフセット文字列形式
A.8 正規表現
Each \u u u \u
付録B (規定) ウェブブラウザ向け追加 ECMAScript 機能
この付録で定義されている ECMAScript 言語の構文と意味論は、ECMAScript
この付録では、ウェブブラウザ ECMAScript
これらの機能は ECMAScript 言語のコア部分とはみなされません。新しく ECMAScript コードを書く場合には、これら機能や動作の利用・存在を前提としないでください。ECMAScript の実装は、ウェブブラウザの一部であるか、ウェブブラウザが遭遇するレガシー ECMAScript コードの実行が必要な場合を除き、これら機能を実装しないことが推奨されます。
B.1 追加構文
B.1.1 HTMLライクコメント
構文
行終端コードポイントを含む
B.1.2 正規表現パターン
この代替パターン文法と意味論はBMPパターンの構文と意味論のみを変更します。以下の文法拡張には [UnicodeMode]
パラメータ付きの生成規則が含まれますが、これらの拡張は
構文
同じ左辺が [+UnicodeMode] および [~UnicodeMode] ガードの両方で出現する場合、それは曖昧性解決の優先順位を制御するためです。
B.1.2.1 静的セマンティクス：早期エラー
- この生成規則によってマッチされたソーステキストがあれば、構文エラーとなる。
加えて、以下の生成規則については、下線部のテキストが追加されて修正される：
-
最初の
ClassAtom のIsCharacterClass がtrue または 2番目のClassAtom のIsCharacterClass がtrue かつこの生成規則に [UnicodeMode] パラメータがある場合、構文エラーとなる。 -
最初の
ClassAtom のIsCharacterClass がfalse 、 2番目のClassAtom のIsCharacterClass がfalse 、 かつ最初のClassAtom のCharacterValue が 2番目のClassAtom のCharacterValue より厳密に大きい場合、構文エラーとなる。
-
ClassAtomNoDash のIsCharacterClass がtrue またはClassAtom のIsCharacterClass がtrue かつこの生成規則に [UnicodeMode] パラメータがある場合、構文エラーとなる。 -
ClassAtomNoDash のIsCharacterClass がfalse 、ClassAtom のIsCharacterClass がfalse 、 かつClassAtomNoDash のCharacterValue がClassAtom のCharacterValue より厳密に大きい場合、構文エラーとなる。
B.1.2.2 静的セマンティクス：CountLeftCapturingParensWithinおよびCountLeftCapturingParensBefore
B.1.2.3 静的セマンティクス：IsCharacterClass
false を返す。
B.1.2.4 静的セマンティクス：CharacterValue
- U+005C（REVERSE SOLIDUS）の数値値を返す。
- ch を
ClassControlLetter がマッチしたコードポイントとする。 - i を ch の数値値とする。
- i を32で割った余りを返す。
LegacyOctalEscapeSequence のMVを返す（12.9.4.3 を参照）。
B.1.2.5 実行時意味論：CompileSubpattern
B.1.2.6 実行時意味論：CompileAssertion
B.1.2.7 実行時意味論：CompileAtom
- A を、文字
\U+005C（REVERSE SOLIDUS）だけを含むCharSet とする。 CharacterSetMatcher (rer, A,false , direction) を返す。
- ch を
ExtendedPatternCharacter で表される文字とする。 - A を、文字 ch だけを含む
CharSet の1要素集合とする。 CharacterSetMatcher (rer, A,false , direction) を返す。
B.1.2.8 実行時意味論：CompileToCharSet
以下の2つの規則は、
- A を、最初の
ClassAtom に rer を引数としてCompileToCharSet を適用した結果とする。 - B を、2番目の
ClassAtom に rer を引数としてCompileToCharSet を適用した結果とする。 - C を、
ClassContents に rer を引数としてCompileToCharSet を適用した結果とする。 - D を
CharacterRangeOrUnion (rer, A, B) の結果とする。 - D と C の和集合を返す。
- A を
ClassAtomNoDash に rer を引数としてCompileToCharSet を適用した結果とする。 - B を
ClassAtom に rer を引数としてCompileToCharSet を適用した結果とする。 - C を
ClassContents に rer を引数としてCompileToCharSet を適用した結果とする。 - D を
CharacterRangeOrUnion (rer, A, B) の結果とする。 - D と C の和集合を返す。
加えて、以下の規則が
- cv をこの
ClassEscape のCharacterValue の値とする。 - cv を文字値とする文字 c を得る。
- 文字 c だけを含む
CharSet を返す。
- 文字
\U+005C（REVERSE SOLIDUS）だけを含むCharSet を返す。
\c という並びが許容される制御文字の後に続かない場合にのみ到達できる。
B.1.2.8.1 CharacterRangeOrUnion ( rer, A, B )
抽象操作 CharacterRangeOrUnion は、引数 rer（
HasEitherUnicodeFlag (rer) がfalse の場合、CharacterRange (A, B) を返す。
B.1.2.9 静的セマンティクス：ParsePattern ( patternText, u, v )
抽象操作
- v が
true かつ u がtrue の場合、- parseResult を、1つ以上の
SyntaxError オブジェクトを含むList とする。
- parseResult を、1つ以上の
- そうでなく v が
true の場合、 - そうでなく u が
true の場合、 - その他の場合、
- parseResult を返す。
B.2 追加の組み込みプロパティ
ECMAScript
B.2.1 グローバルオブジェクトの追加プロパティ
| 組み込み名 | グローバル名 | ECMAScript 言語の関連付け |
|---|---|---|
|
|
escape
|
escape 関数（ |
|
|
unescape
|
unescape 関数（ |
B.2.1.1 escape ( string )
この関数は
数値値が 0x00FF 以下のコード単位を置換する場合は、%xx 形式の2桁のエスケープシーケンスが使用される。数値値が 0x00FF
より大きいコード単位を置換する場合は、%uxxxx 形式の4桁のエスケープシーケンスが使用される。
これは %escape% 組み込みオブジェクトである。
呼び出し時は次の手順を実行する：
- string を ?
ToString (string) に設定する。 - len を string の長さとする。
- R を空文字列とする。
- unescapedSet を
string-concatenation によるASCII ワード文字 と"@*+-./" の連結とする。 - k を 0 とする。
- k < len の間、繰り返す：
- C を string のインデックス k にあるコード単位とする。
- unescapedSet が C を含む場合：
- S を C とする。
- それ以外の場合：
- n を C の数値値とする。
- n < 256 の場合：
- hex を n の大文字16進数表現の文字列とする。
- S を
string-concatenation による"%" とStringPad (hex, 2,"0" ,start ) の連結とする。
- それ以外の場合：
- hex を n の大文字16進数表現の文字列とする。
- S を
string-concatenation による"%u" とStringPad (hex, 4,"0" ,start ) の連結とする。
- R を
string-concatenation による R と S の連結とする。 - k を k + 1 に設定する。
- R を返す。
このエンコーディングは RFC 1738 で記述されているものに部分的に基づいているが、本標準で規定される全体のエンコーディングは RFC 1738 の内容を考慮せず上記に記述されている。このエンコーディングは RFC 3986 による RFC 1738 の変更を反映していない。
B.2.1.2 unescape ( string )
この関数は escape
関数によって導入される種類のエスケープシーケンスごとに、それが表すコード単位へ置換された新しい String 値を生成する。
これは %unescape% 組み込みオブジェクトである。
呼び出し時は次の手順を実行する：
- string を ?
ToString (string) に設定する。 - len を string の長さとする。
- R を空文字列とする。
- k を 0 とする。
- k < len の間、繰り返す：
- C を string のインデックス k にあるコード単位とする。
- C がコード単位 0x0025（パーセント記号）の場合：
- hexDigits を空文字列とする。
- optionalAdvance を 0 とする。
- k + 5 < len かつ string のインデックス
k + 1 がコード単位 0x0075（小文字 u）の場合：
- hexDigits を
substring による string の k + 2 から k + 6 までの部分文字列とする。 - optionalAdvance を 5 に設定する。
- hexDigits を
- それ以外で k + 3 ≤ len の場合：
- hexDigits を
substring による string の k + 1 から k + 3 までの部分文字列とする。 - optionalAdvance を 2 に設定する。
- hexDigits を
- parseResult を
ParseText (hexDigits,HexDigits ) とする。[~Sep] - parseResult が
Parse Node の場合：- n を parseResult の MV とする。
- C を数値値 n のコード単位に設定する。
- k を k + optionalAdvance に設定する。
- R を
string-concatenation による R と C の連結とする。 - k を k + 1 に設定する。
- R を返す。
B.2.2 String.prototype オブジェクトの追加プロパティ
B.2.2.1 String.prototype.substr ( start, length )
このメソッドは
呼び出し時は次の手順を実行する：
- O を ?
RequireObjectCoercible (this value) とする。 - S を ?
ToString (O) とする。 - size を S の長さとする。
- intStart を ?
ToIntegerOrInfinity (start) とする。 - intStart = -∞ の場合、intStart を 0 に設定する。
- intStart < 0 の場合、intStart を
max (size + intStart, 0) に設定する。 - それ以外の場合、intStart を
min (intStart, size) に設定する。 - length が
undefined の場合、intLength を size とする。そうでなければ intLength を ?ToIntegerOrInfinity (length) とする。 - intLength を
clamping により 0 から size の間にクランプした値に設定する。 - intEnd を
min (intStart + intLength, size) とする。 - S の intStart から intEnd までの
substring を返す。
このメソッドは意図的にジェネリックであり、
B.2.2.2 String.prototype.anchor ( name )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"a" ,"name" , name) を返す。
B.2.2.2.1 CreateHTML ( string, tag, attribute, value )
抽象操作 CreateHTML は、引数 string（
- str を ?
RequireObjectCoercible (string) に設定する。 - S を ?
ToString (str) に設定する。 - p1 を
string-concatenation による"<" と tag の連結とする。 - attribute が空文字列でない場合：
- V を ?
ToString (value) に設定する。 - escapedV を V 内のコード単位 0x0022（引用符）をすべて
""" の6コード単位列に置き換えた String 値とする。 - p1 を
string-concatenation による下記の連結とする：- p1
- コード単位 0x0020（スペース）
- attribute
- コード単位 0x003D（イコール）
- コード単位 0x0022（引用符）
- escapedV
- コード単位 0x0022（引用符）
- V を ?
- p2 を
string-concatenation による p1 と">" の連結とする。 - p3 を
string-concatenation による p2 と S の連結とする。 - p4 を
string-concatenation による p3、"</" 、tag、">" の連結とする。 - p4 を返す。
B.2.2.3 String.prototype.big ( )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"big" ,"" ,"" ) を返す。
B.2.2.4 String.prototype.blink ( )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"blink" ,"" ,"" ) を返す。
B.2.2.5 String.prototype.bold ( )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"b" ,"" ,"" ) を返す。
B.2.2.6 String.prototype.fixed ( )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"tt" ,"" ,"" ) を返す。
B.2.2.7 String.prototype.fontcolor ( colour )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"font" ,"color" , colour) を返す。
B.2.2.8 String.prototype.fontsize ( size )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"font" ,"size" , size) を返す。
B.2.2.9 String.prototype.italics ( )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"i" ,"" ,"" ) を返す。
B.2.2.10 String.prototype.link ( url )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"a" ,"href" , url) を返す。
B.2.2.11 String.prototype.small ( )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"small" ,"" ,"" ) を返す。
B.2.2.12 String.prototype.strike ( )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"strike" ,"" ,"" ) を返す。
B.2.2.13 String.prototype.sub ( )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"sub" ,"" ,"" ) を返す。
B.2.2.14 String.prototype.sup ( )
このメソッドは呼び出し時、次の手順を実行する：
- S を
this 値とする。 - ?
CreateHTML (S,"sup" ,"" ,"" ) を返す。
B.2.2.15 String.prototype.trimLeft ( )
B.2.2.16 String.prototype.trimRight ( )
B.2.3 Date.prototype オブジェクトの追加プロパティ
B.2.3.1 Date.prototype.getYear ( )
ほぼすべての目的において getFullYear メソッドが推奨される。これは「2000年問題」を回避できるためである。
このメソッドは呼び出し時、次の手順を実行する：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 YearFromTime (LocalTime (t)) -1900 𝔽 を返す。
B.2.3.2 Date.prototype.setYear ( year )
ほぼすべての目的において setFullYear メソッドが推奨される。これは「2000年問題」を回避できるためである。
このメソッドは呼び出し時、次の手順を実行する：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- y を ?
ToNumber (year) とする。 - t が
NaN の場合 t を+0 𝔽 に設定し、そうでなければ t をLocalTime (t) に設定する。 - yyyy を
MakeFullYear (y) とする。 - d を
MakeDay (yyyy,MonthFromTime (t),DateFromTime (t)) とする。 - date を
MakeDate (d,TimeWithinDay (t)) とする。 - u を
TimeClip (UTC (date)) とする。 - dateObject.[[DateValue]] を u に設定する。
- u を返す。
B.2.3.3 Date.prototype.toGMTString ( )
toUTCString メソッドが推奨される。このメソッドは主に古いコードとの互換性のために提供されている。
B.2.4 RegExp.prototype オブジェクトの追加プロパティ
B.2.4.1 RegExp.prototype.compile ( pattern, flags )
このメソッドは呼び出し時、次の手順を実行する：
- O を
this 値とする。 - ?
RequireInternalSlot (O, [[RegExpMatcher]]) を実行する。 - pattern が
オブジェクト であり、かつ pattern が [[RegExpMatcher]] 内部スロットを持つ場合：- flags が
undefined でない場合、TypeError 例外を throw する。 - P を pattern.[[OriginalSource]] とする。
- F を pattern.[[OriginalFlags]] とする。
- flags が
- それ以外の場合：
- P を pattern とする。
- F を flags とする。
- ?
RegExpInitialize (O, P, F) を返す。
このメソッドは
B.3 その他の追加機能
B.3.1 ラベル付き関数宣言
ECMAScript 2015以前では、
-
この生成規則によってマッチされたソーステキストが
厳格モードコード である場合、構文エラーとなる。
B.3.2 ブロックレベル関数宣言のWebレガシー互換意味論
ECMAScript 2015以前は、ECMAScript仕様は
-
関数が宣言され、単一のブロック内のみで参照される場合。
-
f という名前の
FunctionDeclaration が1つ以上、囲み関数 g の関数コード内に現れ、その宣言がBlock 内にネストされている。 -
g の関数コード内で
var宣言以外の f の他の宣言は現れない。 -
f の
IdentifierReference としての出現は、すべて f の宣言を含むBlock のStatementList 内でのみ発生する。
-
f という名前の
-
関数が宣言され、単一の
Block 内で使用される可能性があるが、同じBlock 内に含まれていない内側の関数定義からも参照される場合。-
f という名前の
FunctionDeclaration が1つ以上、囲み関数 g の関数コード内に現れ、その宣言がBlock 内にネストされている。 -
g の関数コード内で
var宣言以外の f の他の宣言は現れない。 -
f の
IdentifierReference としての出現が、f の宣言を含むBlock のStatementList 内に現れる可能性がある。 -
h という関数内で f の
IdentifierReference としての出現が少なくとも1つあり、他の宣言が h 内からの参照をシャドウしない。 - h の呼び出しはすべて、f の宣言が評価された後に発生する。
-
f という名前の
-
関数が宣言され、単一のブロック内で使用される可能性があるが、後続のブロック内でも参照される場合。
-
f という名前の
FunctionDeclaration が1つ以上、囲み関数 g の関数コード内に現れ、その宣言がBlock 内にネストされている。 -
g の関数コード内で
var宣言以外の f の他の宣言は現れない。 -
f の
IdentifierReference としての出現が、f の宣言を含むBlock のStatementList 内に現れる可能性がある。 -
f の
IdentifierReference としての出現が、f の宣言を含むBlock の字句的後に位置する g の関数コード内で少なくとも1つ現れる。
-
f という名前の
最初の使用例は、ECMAScript 2015で提供される
2番目と3番目の使用例の ECMAScript 2015 との相互運用には、
ECMAScript 実装が診断警告メッセージを報告する仕組みを持つ場合、これらの互換性意味論が適用され、非互換意味論との差異が観測可能な場合は、コードに
B.3.2.1 FunctionDeclarationInstantiationへの変更
- strict が
false の場合、- 任意の
FunctionDeclaration f がStatementList の中で直接含まれるようなBlock ,CaseClause , またはDefaultClause x について、codeContains x がtrue ならば、以下を実行する：- f の
BindingIdentifier のStringValue を F とする。 FunctionDeclaration f を F をBindingIdentifier とするVariableStatement に置き換えた場合、func に対して Early Error が発生せず、かつ parameterNames が F を含まないならば、- 注：この箇所で F の var バインディングが生成されるのは、それが
VarDeclaredName でも、形式的パラメータの名前でも、他の
FunctionDeclaration でもない場合のみである。 - instantiatedVarNames が F を含まず、かつ
F が
"arguments" でない場合、- ! varEnv.CreateMutableBinding(F,
false ) を実行する。 - ! varEnv.InitializeBinding(F,
undefined ) を実行する。 - instantiatedVarNames に F を追加する。
- ! varEnv.CreateMutableBinding(F,
FunctionDeclaration f の評価時、FunctionDeclaration Evaluation アルゴリズム（15.2.6 ）の代わりに、以下を実行する：- fEnv を
現在実行コンテキスト の VariableEnvironment とする。 - bEnv を
現在実行コンテキスト の LexicalEnvironment とする。 - fObj を
! bEnv.GetBindingValue(F,
false ) とする。 - ! fEnv.SetMutableBinding(F,
fObj,
false ) を実行する。 unused を返す。
- fEnv を
- 注：この箇所で F の var バインディングが生成されるのは、それが
VarDeclaredName でも、形式的パラメータの名前でも、他の
- f の
- 任意の
B.3.2.2 GlobalDeclarationInstantiationへの変更
- 次の手順を実行する：
- strict を
ScriptIsStrict (script) とする。 - strict が
false の場合、- declaredFunctionOrVarNames を
list-concatenation による declaredFunctionNames と declaredVarNames の連結とする。 - 任意の
FunctionDeclaration f がStatementList の中で直接含まれるようなBlock ,CaseClause , またはDefaultClause x について、scriptContains x がtrue ならば、以下を実行する：- f の
BindingIdentifier のStringValue を F とする。 FunctionDeclaration f を F をBindingIdentifier とするVariableStatement に置き換えた場合、script に対して Early Error が発生しない場合、HasLexicalDeclaration (env, F) がfalse の場合、- fnDefinable を ?
CanDeclareGlobalVar (env, F) とする。 - fnDefinable が
true の場合、- 注：この箇所で F の var
バインディングが生成されるのは、それが VarDeclaredName
でも、他の
FunctionDeclaration の名前でもない場合のみである。 - declaredFunctionOrVarNames
が F を含まない場合、
- ?
CreateGlobalVarBinding (env, F,false ) を実行する。 - declaredFunctionOrVarNames に F を追加する。
- ?
FunctionDeclaration f の評価時、FunctionDeclaration Evaluation アルゴリズム（15.2.6 ）の代わりに、以下を実行する：- gEnv を
現在実行コンテキスト の VariableEnvironment とする。 - bEnv を
現在実行コンテキスト の LexicalEnvironment とする。 - fObj を
! bEnv.GetBindingValue(F,
false ) とする。 - ? gEnv.SetMutableBinding(F,
fObj,
false ) を実行する。 unused を返す。
- gEnv を
- 注：この箇所で F の var
バインディングが生成されるのは、それが VarDeclaredName
でも、他の
- fnDefinable を ?
- f の
- declaredFunctionOrVarNames を
- strict を
B.3.2.3 EvalDeclarationInstantiationへの変更
- strict が
false の場合、- declaredFunctionOrVarNames を
list-concatenation による declaredFunctionNames と declaredVarNames の連結とする。 - 任意の
FunctionDeclaration f がStatementList の中で直接含まれるようなBlock ,CaseClause , またはDefaultClause x について、bodyContains x がtrue ならば、以下を実行する：- f の
BindingIdentifier のStringValue を F とする。 FunctionDeclaration f を F をBindingIdentifier とするVariableStatement に置き換えた場合、body に対して Early Error が発生しない場合、- bindingExists を
false とする。 - thisEnv を lexEnv とする。
Assert ：次のループは必ず終了する。- thisEnv が varEnv でない間、繰り返す：
- thisEnv が
オブジェクトでない Environment Record ならば、- ! thisEnv.HasBinding(F)
が
true ならば、-
bindingExists を
true に設定する。
-
bindingExists を
- ! thisEnv.HasBinding(F)
が
- thisEnv を thisEnv.[[OuterEnv]] に設定する。
- thisEnv が
- bindingExists が
false かつ varEnv がGlobal Environment Record ならば、HasLexicalDeclaration (varEnv, F) がfalse ならば、- fnDefinable を ?
CanDeclareGlobalVar (varEnv, F) とする。
- fnDefinable を ?
- それ以外の場合、
- fnDefinable を
false とする。
- fnDefinable を
- それ以外の場合、
- fnDefinable を
true とする。
- fnDefinable を
- bindingExists が
false かつ fnDefinable がtrue の場合、- declaredFunctionOrVarNames が F
を含まない場合、
- varEnv が
Global Environment Record ならば、- ?
CreateGlobalVarBinding (varEnv, F,true ) を実行する。
- ?
- それ以外の場合、
- bindingExists を ! varEnv.HasBinding(F) に設定する。
- bindingExists が
false の場合、- ! varEnv.CreateMutableBinding(F,
true ) を実行する。 - ! varEnv.InitializeBinding(F,
undefined ) を実行する。
- ! varEnv.CreateMutableBinding(F,
- declaredFunctionOrVarNames に F を追加する。
- varEnv が
FunctionDeclaration f の評価時、FunctionDeclaration Evaluation アルゴリズム（15.2.6 ）の代わりに、以下を実行する：- gEnv を
現在実行コンテキスト の VariableEnvironment とする。 - bEnv を
現在実行コンテキスト の LexicalEnvironment とする。 - fObj を
! bEnv.GetBindingValue(F,
false ) とする。 - ? gEnv.SetMutableBinding(F,
fObj,
false ) を実行する。 unused を返す。
- gEnv を
- declaredFunctionOrVarNames が F
を含まない場合、
- bindingExists を
- f の
- declaredFunctionOrVarNames を
B.3.2.4 Blockの静的セマンティクス：Early Errorsの変更
-
StatementList のLexicallyDeclaredNames に重複するエントリが含まれる場合、構文エラーとなる。ただし、IsStrict (この生成規則) がfalse であり、重複エントリがすべて FunctionDeclaration によって束縛されている場合は除く。 -
StatementList のLexicallyDeclaredNames の要素が、同じくStatementList のVarDeclaredNames にも現れる場合、構文エラーとなる。
B.3.2.5 switch文の静的セマンティクス：Early Errorsの変更
-
CaseBlock のLexicallyDeclaredNames に重複するエントリが含まれる場合、構文エラーとなる。ただし、IsStrict (この生成規則) がfalse であり、重複エントリがすべて FunctionDeclaration によって束縛されている場合は除く。 -
CaseBlock のLexicallyDeclaredNames の要素が、同じくCaseBlock のVarDeclaredNames にも現れる場合、構文エラーとなる。
B.3.2.6 BlockDeclarationInstantiationへの変更
- ! env.HasBinding(dn) が
false の場合、- ! env.CreateMutableBinding(dn,
false ) を実行する。
- ! env.CreateMutableBinding(dn,
- 次の手順を実行する：
- env における fn のバインディングが初期化されていない場合、
- ! env.InitializeBinding(fn, fo) を実行する。
- それ以外の場合、
Assert ：d はFunctionDeclaration である。- ! env.SetMutableBinding(fn,
fo,
false ) を実行する。
- env における fn のバインディングが初期化されていない場合、
B.3.3 IfStatement の文句内の FunctionDeclaration
以下は
この生成規則は
B.3.4 Catch ブロック内の VariableStatement
小項目
-
CatchParameter のBoundNames に重複要素がある場合、構文エラーとなる。 -
CatchParameter のBoundNames の要素が、Block のLexicallyDeclaredNames にも現れる場合、構文エラーとなる。 -
CatchParameter のBoundNames の要素が、Block のVarDeclaredNames にも現れる場合、ただしCatchParameter がCatchParameter : BindingIdentifier
var 宣言が含まれることがある。実行時には、こうした束縛は
VariableDeclarationEnvironment で生成される。同名の var 宣言の var
バインディングではなく対応する catch パラメータに代入されることになる。
この変更された動作は、var や function 宣言にも適用される。この変更は
- thisEnv が
Catch 節のEnvironment Record でない場合、SyntaxError 例外を throw する。
- thisEnv が
Catch 節のEnvironment Record でない場合、bindingExists をtrue にする。
B.3.5 ForIn 文ヘッドの Initializer
以下は
この生成規則は
Statement に labelSet を引数としてContainsDuplicateLabels を返す。
Statement に labelSet を引数としてContainsUndefinedBreakTarget を返す。
Statement に iterationSet と « » を引数としてContainsUndefinedContinueTarget を返す。
false を返す。
- names1 を
BindingIdentifier のBoundNames とする。 - names2 を
Statement のVarDeclaredNames とする。 - names1 と names2 の
list-concatenation を返す。
- declarations1 を «
BindingIdentifier » とする。 - declarations2 を
Statement のVarScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
- bindingId を
BindingIdentifier のStringValue とする。 - lhs を ?
ResolveBinding (bindingId) とする。 IsAnonymousFunctionDefinition (Initializer ) がtrue の場合、- value を ?
NamedEvaluation (Initializer , bindingId) とする。
- value を ?
- それ以外の場合、
- rhs を ?
Evaluation (Initializer ) とする。 - value を ?
GetValue (rhs) とする。
- rhs を ?
- ?
PutValue (lhs, value) を実行する。 - keyResult を ?
ForIn/OfHeadEvaluation (« »,Expression ,enumerate ) とする。 - ?
ForIn/OfBodyEvaluation (BindingIdentifier ,Statement , keyResult,enumerate ,var-binding , labelSet) を返す。
B.3.6 [[IsHTMLDDA]] 内部スロット
[[IsHTMLDDA]] 内部スロットは typeof
演算子
[[IsHTMLDDA]] 内部スロットを持つオブジェクトは本仕様では決して生成されない。ただし、ウェブブラウザの document.all
オブジェクト は、Web互換性のために存在する document.all以外でこのスロットを持つオブジェクトを実装が生成すべきではない。
B.3.6.1 ToBooleanへの変更
以下の手順は
- argument が
オブジェクト であり、かつ argument が [[IsHTMLDDA]] 内部スロットを持つ場合、false を返す。
B.3.6.2 IsLooselyEqualへの変更
以下の手順は
B.3.6.3 typeof 演算子への変更
以下の手順は typeof
の評価意味論
- val が [[IsHTMLDDA]]
内部スロットを持つ場合、
"undefined" を返す。
B.3.7 HostMakeJobCallbackの非デフォルト動作
B.3.8 HostEnsureCanAddPrivateElementの非デフォルト動作
B.3.9 関数呼び出し代入ターゲットの実行時エラー
関数呼び出し（
代入ターゲットが = または ??=、&&=、||=）には適用されない。
附属書 C (参考) ECMAScriptの厳格モード
厳格モードの制約と例外
-
implements,interface,let,package,private,protected,public,static,yieldは、予約語 であり、厳格モードコード 内で予約されている。（12.7.2 ）。 -
適合実装は、
厳格モードコード を処理する際、NumericLiteral :: LegacyOctalIntegerLiteral DecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral -
適合実装は、
厳格モードコード を処理する際、EscapeSequence :: LegacyOctalEscapeSequence EscapeSequence :: NonOctalDecimalEscapeSequence -
宣言されていない識別子や解決できない参照への代入は、
グローバルオブジェクト にプロパティを作成しない。厳格モードコード 内で単純代入が発生した場合、そのLeftHandSideExpression は解決不能なReferenceに評価されてはならない。そうなった場合、ReferenceError 例外が投げられる（6.2.5.6 ）。またLeftHandSideExpression は、属性値 { [[Writable]]:false } を持つデータプロパティ 、属性値 { [[Set]]:undefined } を持つアクセサプロパティ 、または[[Extensible]]内部スロットがfalse であるオブジェクトの存在しないプロパティへの参照であってはならない。これらの場合、TypeError例外が投げられる（13.15 ）。 -
IdentifierReference のStringValue が"eval" または"arguments" の場合、Assignment演算子（13.15 ）、UpdateExpression （13.4 ）、Prefix Increment（13.4.4 ）、Prefix Decrement（13.4.5 ）演算子のLeftHandSideExpression やUnaryExpression として現れてはならない。 -
厳格関数 のArgumentsオブジェクトは、アクセサプロパティ"callee" を非設定可能として定義し、アクセス時にTypeError 例外を投げる（10.4.4.6 ）。 -
厳格関数 のArgumentsオブジェクトは、対応する関数の形式的パラメータバインディングと配列インデックス のプロパティ値を動的に共有しない（10.4.4 ）。 -
厳格関数 でArgumentsオブジェクトが生成された場合、ローカル識別子argumentsの束縛は不変であり、代入式のターゲットにしてはならない（10.2.11 ）。 -
BindingIdentifier のStringValue が"eval" または"arguments" であり、厳格モードコード 内で現れる場合はSyntaxError となる（13.1.1 ）。 -
厳格モードのevalコードは、呼び出し元evalの変数環境内に変数や関数をインスタンス化できない。代わりに新しい変数環境が作成され、evalコードの宣言束縛のインスタンス化に用いられる（
19.2.1 ）。 -
this が厳格モードコード 内で評価されるとき、this 値はオブジェクトに変換されない。this 値がundefined またはnull の場合、グローバルオブジェクト に変換されず、プリミティブ値もラッパーオブジェクトに変換されない。関数呼び出し（Function.prototype.applyやFunction.prototype.callによる呼び出しを含む）で渡されたthis 値もオブジェクトに変換されない（10.2.1.2 ,20.2.3.1 ,20.2.3.3 ）。 -
delete演算子が厳格モードコード 内で現れる場合、UnaryExpression が変数、関数引数、関数名への直接参照であると、SyntaxError が投げられる（13.5.1.1 ）。 -
delete演算子が厳格モードコード 内で現れる場合、削除対象プロパティが属性 { [[Configurable]]:false } を持つ、または削除できない場合、TypeError が投げられる（13.5.1.2 ）。 -
厳格モードコード にはWithStatement を含めることはできない。そうした文脈でWithStatement が現れるとSyntaxError となる（14.11.1 ）。 -
CatchParameter が厳格モードコード 内で現れ、そのBoundNames にevalまたはargumentsが含まれる場合、SyntaxError となる（14.15.1 ）。 -
BindingIdentifier がFormalParameters 内で複数回現れ、厳格関数 である場合、関数、Generator、AsyncFunctionコンストラクタ でそのような関数を作成しようとするとSyntaxError となる（15.2.1 ,20.2.1.1.1 ）。 -
実装は本仕様で定義される範囲を超えて、
厳格関数 内の関数インスタンスのプロパティ"caller" や"arguments" の意味を拡張してはならない。
附属書 D (参考) ホスト階層化ポイント
D.1 ホストフック
D.2 ホスト定義フィールド
[[HostDefined]] (
[[HostDefined]] (
[[HostDefined]] (
[[HostDefined]] (
[[HostSynchronizesWith]] (Candidate Execution上):
[[IsHTMLDDA]]:
D.3 ホスト定義オブジェクト
D.4 ジョブの実行
D.5 エキゾチックオブジェクトの内部メソッド
D.6 組み込みオブジェクトとメソッド
附属書 E (参考) ECMAScript 2015における修正および互換性に影響を与える可能性のある明確化
Date.prototype.toStringが
/のみのエスケープが要求されていた。
String.prototype.matchおよびString.prototype.replaceの仕様が、パターン引数がglobalフラグを持つRegExp値である場合に誤っていた。以前の仕様ではパターンのlastIndexが変化しなければ毎回1増加すべきとしていたが、正しい挙動はパターンが空文字列にマッチした場合にのみlastIndexを1増加させることである。
附属書 F (参考) 以前の版との非互換性を導入する追加・変更
Space_Separator（Zs）カテゴリーでありECMAScript 2015では空白として扱われていたが、Unicode
6.3.0以降Format（Cf）カテゴリーに移動した。これにより空白に敏感なメソッドの挙動が変化し、"\u180E".trim().lengthは従来0だったが、ECMAScript
2016以降は1となる。またECMAScript 2017ではUnicodeの最新バージョンを常に使用することが必須となった。
[トークンが続く場合、それは
()トークンの直後がlet [トークン列の場合、letは
()トークンの直後がlet [トークン列の場合、letは
in
var宣言を含む場合、
evalがvarやFunctionDeclaration宣言で
Object.freezeの引数がオブジェクトでない場合、独自プロパティを持たない非拡張可能な
Object.getOwnPropertyDescriptorの引数がオブジェクトでない場合、
Object.getOwnPropertyNamesの引数がオブジェクトでない場合、
Object.getPrototypeOfの引数がオブジェクトでない場合、
Object.isExtensibleの引数がオブジェクトでない場合、独自プロパティを持たない非拡張可能な
Object.isFrozenの引数がオブジェクトでない場合、独自プロパティを持たない非拡張可能な
Object.isSealedの引数がオブジェクトでない場合、独自プロパティを持たない非拡張可能な
Object.keysの引数がオブジェクトでない場合、
Object.preventExtensionsの引数がオブジェクトでない場合、独自プロパティを持たない非拡張可能な
Object.sealの引数がオブジェクトでない場合、独自プロパティを持たない非拡張可能な
String.prototype.localeCompare関数はUnicode規格で正規的に等価な文字列を同一とみなさなければならない。従来の版では実装は正規的等価性を無視してビット比較を用いることも許されていた。
String.prototype.trimメソッドがUnicode
BMP外にも存在する可能性のある空白コードポイントを認識するように定義されている。ただし、Unicode
7現在そのようなコードポイントは定義されていない。従来の版ではそうしたコードポイントは空白と認識されなかった。
Atomics.wakeがAtomics.notifyに改名され、Atomics.waitとの混同が防止された。
awaitによってキューされるthen()呼び出しとawait式の解決順序に観測可能な差が生じる可能性がある。
参考文献
-
IEEE 754-2019: IEEE Standard for Floating-Point Arithmetic.
Institute of Electrical and Electronic Engineers, New York (2019)
注 IEEE 754-2008とIEEE 754-2019の間には、ECMA-262仕様に影響する規範的な変更はありません。
- Unicode Standard（最新バージョンは <https://unicode.org/versions/latest> で公開）
- Unicode Technical Note #5: Canonical Equivalence in Applications（<https://unicode.org/notes/tn5/> 参照）
- Unicode Technical Standard #10: Unicode Collation Algorithm（<https://unicode.org/reports/tr10/> 参照）
- Unicode Standard Annex #15, Unicode Normalization Forms（<https://unicode.org/reports/tr15/> 参照）
- Unicode Standard Annex #18: Unicode Regular Expressions（<https://unicode.org/reports/tr18/> 参照）
-
Unicode Standard Annex #24: Unicode
ScriptProperty（<https://unicode.org/reports/tr24/> 参照） - Unicode Standard Annex #31, Unicode Identifiers and Pattern Syntax（<https://unicode.org/reports/tr31/> 参照）
- Unicode Standard Annex #44: Unicode Character Database（<https://unicode.org/reports/tr44/> 参照）
- Unicode Technical Standard #51: Unicode Emoji（<https://unicode.org/reports/tr51/> 参照）
- IANA Time Zone Database（<https://www.iana.org/time-zones> 参照）
- ISO 8601:2004(E) データ要素および交換形式 — 情報交換 — 日付と時刻の表現
- RFC 1738 “Uniform Resource Locators (URL)”（<https://tools.ietf.org/html/rfc1738> 参照）
- RFC 2396 “Uniform Resource Identifiers (URI): Generic Syntax”（<https://tools.ietf.org/html/rfc2396> 参照）
- RFC 3629 “UTF-8, a transformation format of ISO 10646”（<https://tools.ietf.org/html/rfc3629> 参照）
- RFC 7231 “Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content”（<https://tools.ietf.org/html/rfc7231> 参照）
奥付
本仕様はGitHub上で、Ecmarkupと呼ばれるプレーンテキストソース形式で執筆されています。EcmarkupはHTMLおよびMarkdownの方言であり、ECMAScript仕様をプレーンテキストで執筆し、編集方針に従った完全なHTMLレンダリングへ処理するためのフレームワークとツールセットを提供します。Ecmarkupは、文法定義のためのGrammarkdownやアルゴリズム手順記述のためのEcmarkdownなど、他の形式や技術と統合されて構築されています。PDFレンダリングはプリントスタイルシートを利用し、CSS Paged Media仕様を活用してPrinceXMLで変換されています。
以前の版の仕様はWordで執筆されていました。本版の基礎となったEcmarkupソーステキストは、ECMAScript 2015のWord文書を自動変換ツールでEcmarkupへ変換することで作成されました。
Copyright & Software License
Ecma International
Rue du Rhone 114
CH-1204 Geneva
Tel: +41 22 849 6000
Fax: +41 22 849 6001
Web: https://ecma-international.org/
Copyright Notice
© 2025 Ecma International
This draft document may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published, and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this section are included on all such copies and derivative works. However, this document itself may not be modified in any way, including by removing the copyright notice or references to Ecma International, except as needed for the purpose of developing any document or deliverable produced by Ecma International.
This disclaimer is valid only prior to final version of this document. After approval all rights on the standard are reserved by Ecma International.
The limited permissions are granted through the standardization phase and will not be revoked by Ecma International or its successors or assigns during this time.
This document and the information contained herein is provided on an "AS IS" basis and ECMA INTERNATIONAL DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Software License
All Software contained in this document ("Software") is protected by copyright and is being made available under the "BSD License", included below. This Software may be subject to third party rights (rights from parties other than Ecma International), including patent rights, and no licenses under such third party rights are granted under this license even if the third party concerned is a member of Ecma International. SEE THE ECMA CODE OF CONDUCT IN PATENT MATTERS AVAILABLE AT https://ecma-international.org/memento/codeofconduct.htm FOR INFORMATION REGARDING THE LICENSING OF PATENT CLAIMS THAT ARE REQUIRED TO IMPLEMENT ECMA INTERNATIONAL STANDARDS.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of the authors nor Ecma International may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE ECMA INTERNATIONAL "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ECMA INTERNATIONAL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.